Claudeception — 把经验写回知识目录
先判断放在哪里
- 换到无关仓库仍然成立 →
framework/<主题>/。 - 依赖某个仓库的代码、命令或流程 →
repos/<仓库>/<主题>/。 - 根因属于多个模型共用的代码 →
repos/<仓库>/components/<模块>/。 - 根因只属于某个模型 →
repos/<仓库>/models/<模型>/。 - 当前机器地址、账号、cache 或 venv → ignored
local/,不进入知识页面。
具体失败写到最近目录的 incidents/;稳定方法写到 guide、rules 或 architecture。归属规则见 目录归属,复盘规则见 复盘和错题。
写之前
- 从
framework/_index.md和repos/_index.md找最近入口。 - 用标题、错误签名和关键词全文搜索,确认没有重复正文。
- 明确页面最终路径和需要更新的
_index.md。 - 去掉私人 host、token、账号、私钥和用户绝对路径。
错题格式
按 错题正文格式 编写,一篇只写一件事故。至少包含:
- 编号;
- 归属;
- 状态;
- 搜索词;
- 影响范围;
- 当时在做什么、现象、影响、原因、修复、验证和防复发。
根因没查清时状态写“待归类”或“处理中”,禁止把猜测伪装成结论。
稳定经验格式
普通 Markdown 即可,不要求 YAML。标题和正文要让人能直接搜索;在最近 _index.md 增加一行“遇到什么 → 查看哪里”。
如果经验来自一篇错题,在错题末尾增加“已提炼到”链接;稳定页面不复制完整事故经过。
写完必做
- 更新当前目录
_index.md。 - 如果新建了子目录,更新上一层
_index.md。 - 修复所有相对链接。
- 运行
python tools/check_knowledge_tree.py。 - 同一类错误反复发生且需要每次开工拦截时:跨仓库都成立才建议升级到根
CLAUDE.md;只属于一个仓库则写入并链接repos/<仓库>/rules.md。
不要
- 写入系统、全局或个人 memory。
- 建立
_private/或第二套索引。 - 生成新
SKILL.md。 - 重复已有正文。
- 保存一次性聊天流水账、完整长日志或未经验证的猜测。
- 保存密码、真实 IP、账号、私钥或用户绝对路径。