CraftKit/plugins/skill/skills/guidance/references/layout.md

检索布局

来源优先级

1. 用户当前明确指令。
2. 目标目录适用的 AGENTS.md。
3. .craftkit/project.json 声明的项目边界和入口。
4. .craftkit/agents/、.craftkit/standards/、.craftkit/knowledge/ 中的项目资料。
5. Skill 随附的中性公共基线。
6. 现有代码，只用于规范未覆盖时观察项目现状。

同一层出现冲突时，不静默选择：列出冲突文件、适用范围和需要用户决定的事项。

渐进加载

先读入口，再读路由，最后读正文：

index.md
└─ domain/index.md
   ├─ layers/topic.md
   └─ rules/detail.md

• 第一跳只判断领域和候选路径。
• 第二跳只读取当前任务相关的层或横切主题。
• 第三跳只展开命中的规则正文。
• 高置信规则已经覆盖问题时停止，不为“完整”继续追踪无关链接。
• 索引无效时使用文件名、标题和关键词搜索，并在输出中标注使用了兜底检索。

项目目录

.craftkit/
├─ project.json
├─ agents/
├─ standards/
├─ knowledge/
├─ handoff/
├─ local/
└─ cache/

前五项可以是共享项目资产。local/ 和 cache/ 应由 .craftkit/.gitignore 排除，不参与普通共享规范检索。