用途：帮助 AI 智能体记录并复用项目中的经验教训，减少重复错误，核心原则是“学一次，永久避免”。
触发时机：任务失败或报错、同一问题重试 2 次以上、任务复杂度超出预期，或用户明确要求记录；触发后须先向用户确认，未获确认不得创建文件。
使用方式：确认后创建 docs/lessons/YYYY-MM-DD-topic-slug.md（小写 kebab-case，2-4 词），内容用 references/LESSON_TEMPLATE.md 模板，控制在 200-300 词。随后更新索引：若存在 AGENTS.md 则用 AGENTS.md，否则若存在 CLAUDE.md 则用 CLAUDE.md，都不存在则询问用户选择；在 ## Lessons Learned 下加入一行摘要，并保留必需策略句，说明类似任务必须先阅读相关教训文件；同一路径已存在则更新该行而非重复添加。除用户明确要求外，不要同时更新两个文件。
强制复习：开始任务前先按同样规则确定索引文件，检查其中是否有 ## Lessons Learned，扫描摘要并阅读与当前任务领域相关的教训全文，再按指引实施。
适用场景：编码任务中的类型错误、异步与循环、状态修改、API 集成、配置错误等反复出现的问题。
限制：不能替代正式文档；质量依赖人工把关；记录可能累积噪音，需定期清理与合并过时条目。