# 初始化经验库

1. 检查 `.craftkit/knowledge/pitfalls/`、知识索引和适用的 Agent 说明。
2. 目录已有内容时不重组，只报告索引缺口和冲突。
3. 目录不存在时展示拟创建的 `INDEX.md` 内容；用户确认后仅创建目录和索引，不创建空分类。
4. 项目尚无 `.craftkit` 时先使用项目初始化约定建立最小目录，不自行复制完整模板树。
5. 检查 `.craftkit` 没有被整体忽略，且 `pitfalls/` 属于可共享内容；发现忽略冲突时停止处理。

索引基于 `assets/index.md` 独立生成，并根据项目已有领域词汇补充；不得预置特定框架、组件或业务分类。