SuperAPI AI 工具集

postmortem-review

办公与效率

查看项目

更新于 10-19 16:16

技能介绍

用途

postmortem-review 用于在解决问题之后进行结构化事后复盘,把踩过的坑和解决方案记录下来,避免重复犯错,并将教训沉淀为文档和记忆。适用场景包括:解决复杂问题后、踩坑后、线上故障修复后,以及用户说出“postmortem”“复盘”“总结问题”“事后分析”时。

主要能力

该技能提供一套分步复盘流程:

  1. 收集信息:引导用户回顾问题是什么、什么时候发现、尝试了哪些解决方案、最终如何解决、根本原因是什么。
  2. 还原时间线:整理事件发生的时间顺序,例如发现问题、尝试方案 A、发现方案 A 无效、找到根因、解决问题等节点。
  3. 创建 Postmortem 文档:在 docs/postmortem/YYYY-MM-DD-简短描述.md 生成文档,包含标题、日期、发现者、严重程度、问题描述、时间线、根因分析(表面原因与真正原因)、解决方案、预防措施、教训总结,以及是否写入全局记忆的勾选项。
  4. 判断是否写入全局记忆:若问题具有普遍性(跨项目可能遇到、涉及通用工具或框架、属于常见陷阱),建议写入 ~/.agents/memory/lessons-learned.md。
  5. 确认复盘完成:向用户报告 Postmortem 文档已创建、是否已写入全局记忆,并给出建议的后续行动。

使用方式

在符合上述场景时调用该技能,按其步骤引导用户回顾信息、整理时间线,并按模板创建文档。最后根据问题普遍性决定是否写入全局记忆。

适用场景

  • 修复线上故障后
  • 解决复杂技术问题后
  • 踩坑并找到解决方案后
  • 用户主动要求复盘或事后分析时

注意事项与限制

复盘应聚焦学习和改进,不是追责;记录要客观、具体;根因分析要深入,不要停留在表面;预防措施要可执行。资料未提供该技能的安装命令、收费方式、支持的平台或其他技术限制等细节,暂未提供。