对话复盘与经验沉淀

要解决什么问题

技术对话里踩过的坑、做过的非显然决策、写好的脚本，往往只留在当次上下文里。会话一关，下次同类问题又要从头摸索。这个技能把「刚结束的对话」当成输入，跑一条固定的复盘流水线，让经验变成项目文档、skill 内 lessons 或可写入 CLAUDE.md / .cursorrules 的规则。

技能如何工作

触发词包括「复盘」、/retrospective-lesson，或「沉淀 / 总结 / 记下来 / SOP / 更新记忆」等自然说法。主 agent 先判断是否值得复盘（根因级踩坑、非显然决策、可复用命令脚本、工具非常规用法等）；都不满足时会问你是否还要复盘，而不是硬凑。

流程分四段：

• 阶段 0.5：把对话压成五段素材（需求、环境约束、执行步骤、坑、产出物），每段 ≤200 字，避免把整段原文丢给后续分析。
• 阶段一：按复杂度选快档（主 agent 自跑理解问题 / 抽取解法 / 防复发三维度）或全档（六路并行/串行：理解问题、抽取解法、文档互链、防复发、YAML 标签、排版大纲）。单路失败会重试、主 agent 补跑或降级，不静默丢维度。
• 阶段二：用 frontmatter + 大纲整合成 Markdown；速查用表格、复用用代码块、验证用 checkbox；落盘三选一：项目 docs/lessons-learned/、本 skill 的 lessons-learned/，或记忆文件。
• 阶段三：写入前给用户确认；只写可迁移的短规则，并用「下次同类问题能否直接走对路」自检。
• 阶段四（可选）：按你的要求归档到外部知识库。

包内 references/prompts.md 提供全档六路可复用 prompt；故障与适用边界见 references/troubleshooting.md。

适用边界与注意点

图片对话、多人协作、超短会话等场景可能不适合完整复盘；质量清单要求每个坑都有对应预防/检查项，且「一句话精髓」能独立成立。记忆写入未确认视为不通过；同一轮复盘不要同时写多处落盘。