技能介绍

解决什么问题

工程师的高频痛点：修完一个复杂 bug、写完一份报告之后，真正有价值的经验——哪一步判断错了、哪个环节可以换种做法——随着对话结束就散了。下次遇到同类任务，往往从零开始，重复踩同一个坑。写正式的复盘文档太重，完全不做复盘又等于把教训直接丢弃。这个技能补上的正是中间那一档：用极低成本把「这次学到了什么」留下来。

核心机制：三问一行动

三问一行动模板：每次复盘输出不超过 8 行，围绕「差在哪」「做对了什么」「下次怎么做」三个问题展开，最终落到一个可执行的行动上。
触发时机：完成多步骤任务、被用户纠正、自己发现更优方案，或用户明确要求复盘时触发；简单问答与闲聊不触发。
5 秒判断：复盘前先用清单快速自检——答案能帮「下次的自己」省时间就值这 30 秒，一次性、不会再遇到的任务直接跳过。
沉淀路径：复盘结果写入工作区记忆文件，如 MEMORY.md、CLAUDE.md，或项目的 .learnings/ 目录，格式保持简短。
规则进化：定期回顾时，重复出现 2 次以上的问题这周修掉，3 次以上的经验升级为硬规则，逐步沉淀进 SOUL.md，形成长期工作法则。

适用边界与注意点

它不替代长复盘：大事故、大项目应当单独写一篇分析，8 行的篇幅装不下。
默认不会自动触发，这是刻意的设计选择，避免每轮对话都被复盘打断；想自动化可在 AGENTS.md 或 SOUL.md 中配置规则，支持 Hook（如 PostToolUse、UserPromptSubmit）的客户端还能在任务完成或命令失败时自动标记提醒。
内容写得太虚（例如「做得不好」）等于没写：「差在哪」要落到具体行为而非情绪，「下次」要写成一句可执行的话。
一个任务只写一条复盘：纠正和新发现都作为这条复盘的素材，而不是拆成多条。
外部因素导致的失败（网络中断、服务挂掉）不归因到自身方法，不记入复盘。