用途
postmortem-review 用于在解决问题之后进行结构化事后复盘,把踩过的坑和解决方案记录下来,避免重复犯错,并将教训沉淀为文档和记忆。适用场景包括:解决复杂问题后、踩坑后、线上故障修复后,以及用户说出“postmortem”“复盘”“总结问题”“事后分析”时。
主要能力
该技能提供一套分步复盘流程:
- 收集信息:引导用户回顾问题是什么、什么时候发现、尝试了哪些解决方案、最终如何解决、根本原因是什么。
- 还原时间线:整理事件发生的时间顺序,例如发现问题、尝试方案 A、发现方案 A 无效、找到根因、解决问题等节点。
- 创建 Postmortem 文档:在
docs/postmortem/YYYY-MM-DD-简短描述.md生成文档,包含标题、日期、发现者、严重程度、问题描述、时间线、根因分析(表面原因与真正原因)、解决方案、预防措施、教训总结,以及是否写入全局记忆的勾选项。 - 判断是否写入全局记忆:若问题具有普遍性(跨项目可能遇到、涉及通用工具或框架、属于常见陷阱),建议写入
~/.agents/memory/lessons-learned.md。 - 确认复盘完成:向用户报告 Postmortem 文档已创建、是否已写入全局记忆,并给出建议的后续行动。
使用方式
在符合上述场景时调用该技能,按其步骤引导用户回顾信息、整理时间线,并按模板创建文档。最后根据问题普遍性决定是否写入全局记忆。
适用场景
- 修复线上故障后
- 解决复杂技术问题后
- 踩坑并找到解决方案后
- 用户主动要求复盘或事后分析时
注意事项与限制
复盘应聚焦学习和改进,不是追责;记录要客观、具体;根因分析要深入,不要停留在表面;预防措施要可执行。资料未提供该技能的安装命令、收费方式、支持的平台或其他技术限制等细节,暂未提供。