用途：把已完成的排错结果沉淀为可复用长期记忆，保存根因、有效修复路径、错误假设与验证证据，减少后续 agent 重复弯路。核心原则是记录决策链，不记流水账。
适用场景：用户要求更新 AI 记忆文档、记录经验教训、补充事故记录或复盘摘要；bug 已复现且有效修复路径明确；经验属于仓库特有知识；需要同步到本地 MCP 记忆（如 Memorix）。不适用：bug 仍在调查、根因未确认；用户要的是修复实现；只有猜测、片段证据或临时绕过方案。
前置输入：写记忆前需能回答六点——表面现象、实际根因、浪费时间的错误假设或误导信号、最终修好的具体改动、验证证据、写入位置。任一项答不上来应先完成排错。
写入位置：仓库级可复用规则写根级 CLAUDE.md、AGENTS.md、GEMINI.md；跨会话本地记忆写入 Memorix，类型用 gotcha、decision 或 problem-solution；包级 prompts、plans、reports 仅在用户明确要求时写入。默认只要影响全仓库未来 agent，就优先写根级文档。
记录内容与模板：至少覆盖问题现象、根因、关键线索、有效修复、验证方式、后续约束六项。模板为“问题现象/根因/关键误导点/有效修复/验证方式/后续约束”，面向未来复用，而非复述完整排错过程。
限制：不得用于修复 bug 本身；不得在根因未确认时提前撰写；具体使用命令、工具链与模板以仓库实际为准，资料未提供自动化脚本或平台限制说明。