feat(skill): 新增项目规范与初始化 Skill

2026-08-25 14:52:43 +08:00
parent ac189b8395
commit dbc2f65154
40 changed files with 587 additions and 19 deletions
@@ -0,0 +1,44 @@
+# 检索布局
+
+## 来源优先级
+
+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` 排除，不参与普通共享规范检索。