事后剖析文档编写
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/postmortem-writing。
技能介绍
要解决什么问题
线上事故之后,团队往往卡在「谁的责任」和「写一份能交差的报告」之间:时间线模糊、根因停在「有人误操作」、行动项没人认领,复盘开完就归档,同类故障照样再来。本技能面向 SEV1/SEV2、长时间用户影响、数据或安全事件、以及值得记录的险兆与新故障模式,帮助你把复盘写成 无指责、可验证、可跟进 的工程文档,而不是问责材料。
技能如何工作
核心框架是 无指责文化:问「什么条件允许了这种情况发生」,把焦点从个人错误转到 系统与流程 是否允许错误发生。编写上提供三类模板——标准事后剖析(含架构与时间线示意)、5 个为什么 根因链、以及 轻微事故快速版,并配套 主持指南 与常见 反模式对照表(指责游戏、浅层分析、无行动项、行动过大、无跟进)。
实践节奏建议:尽快启动(记忆衰减快)、时间戳与错误信息 写具体、用图表固定事实、每个改进行动 指定负责人 并在工单里追踪;需要更细的步骤与示例时,可对照技能内的 resources/implementation-playbook.md。
适用边界
- 任务与 事后剖析 / 事件复盘 无关时,不必启用本技能。
- 它不提供监控告警、故障处置或合规审计的替代方案,只覆盖 文档结构、会议主持与组织学习 这一层。
- 不要点名羞辱、不要把小事故一律跳过——小事故常暴露模式;行动项应 可达、有意义,并坚持 后续验证 是否真正完成。
使用场景
- SEV1 或 SEV2 事故结束后,需要在 48 小时内产出带时间线与架构图的标准事后剖析文档
- 用户可见宕机超过 15 分钟后,主持无指责复盘会并梳理促成因素与可执行改进行动项
- 数据丢失或安全事件闭环后,用「5 个为什么」写清根因链,避免停在「人为失误」
- 出现新故障模式或需异常人工干预的事件后,写快速版事后剖析并登记工单跟进
适合人员
- 负责线上稳定性、事故后必须牵头写复盘并推动改进行动落地的 SRE 或平台工程师
- 作为 incident commander 或 on-call 负责人,需要主持无指责事后剖析会议并汇总多方陈述的运维主管
- 安全或数据团队工程师,在数据泄露、误删或合规相关事件后需撰写可审计、无指责的过程说明
- 工程经理或技术负责人,希望把险兆与小事故也纳入复盘模板,避免团队重复踩同一类坑