用途：把一次性对话中的高价值经验转成项目内可复用资产。触发场景包括命令或工具失败、用户纠正、用户要求缺失能力、外部 API 失败、知识过时、发现更好做法。
主要能力：按情况分别记录到 .learnings/ERRORS.md、LEARNINGS.md、FEATURE_REQUESTS.md；支持 correction、knowledge_gap、best_practice 等类别；提供 Learning、Error、Feature Request 三类条目格式，含 Priority、Status、Area、Metadata、See Also、Pattern-Key、Recurrence-Count 等字段；支持 pending、in_progress、resolved、promoted、wont_fix 生命周期，解决时追加 Resolution 块。
使用方式：记录前先搜索已有条目，命令为 grep -r "keyword" .learnings/；相似条目用 See Also 关联，Recurrence-Count 达到 3 时建议提升为项目规则。广泛适用的经验可提升到 CLAUDE.md 或 AGENTS.md，复杂模式可提取为新 skill，提升后把原条目 Status 更新为 promoted。
适用场景：项目约定、工作流规则、可复用模式的沉淀；跨任务反复出现的错误与纠正；用户明确要求存为 skill 的情况。
限制：只保留高信号信息，明显一次性错误、无需复盘的小问题、与项目无关的常识不应记录。项目内 SelfImprovementHook 可自动记录基础条目，但高质量 learning 仍需在任务结束前主动整理。定期回顾时机包括开始大型任务前、完成功能后、在有历史 learning 的区域工作时。