45 lines
1.3 KiB
Markdown
45 lines
1.3 KiB
Markdown
# 检索布局
|
|
|
|
## 来源优先级
|
|
|
|
1. 用户当前明确指令。
|
|
2. 目标目录适用的 `AGENTS.md`。
|
|
3. `.craftkit/project.json` 声明的项目边界和入口。
|
|
4. `.craftkit/agents/`、`.craftkit/standards/`、`.craftkit/knowledge/` 中的项目资料。
|
|
5. Skill 随附的中性公共基线。
|
|
6. 现有代码，只用于规范未覆盖时观察项目现状。
|
|
|
|
同一层出现冲突时，不静默选择：列出冲突文件、适用范围和需要用户决定的事项。
|
|
|
|
## 渐进加载
|
|
|
|
先读入口，再读路由，最后读正文：
|
|
|
|
```text
|
|
index.md
|
|
└─ domain/index.md
|
|
├─ layers/topic.md
|
|
└─ rules/detail.md
|
|
```
|
|
|
|
- 第一跳只判断领域和候选路径。
|
|
- 第二跳只读取当前任务相关的层或横切主题。
|
|
- 第三跳只展开命中的规则正文。
|
|
- 高置信规则已经覆盖问题时停止，不为“完整”继续追踪无关链接。
|
|
- 索引无效时使用文件名、标题和关键词搜索，并在输出中标注使用了兜底检索。
|
|
|
|
## 项目目录
|
|
|
|
```text
|
|
.craftkit/
|
|
├─ project.json
|
|
├─ agents/
|
|
├─ standards/
|
|
├─ knowledge/
|
|
├─ handoff/
|
|
├─ local/
|
|
└─ cache/
|
|
```
|
|
|
|
前五项可以是共享项目资产。`local/` 和 `cache/` 应由 `.craftkit/.gitignore` 排除，不参与普通共享规范检索。
|