技能使用指南

postmortem-writing(事后分析撰写)Skill 是什么?如何一键生成无指责事后报告?

事后分析撰写Skill 内置标准事后报告、5 Whys 根因分析与快速复盘三套模板,强调无指责措辞与行动项闭环,帮助 SRE 与研发团队十几分钟产出结构完整的故障复盘初稿。了解它的安装方式、使用步骤、竞品对比与典型场景,快速把每次故障转化为组织能力。

事后分析撰写Skillpostmortem-writing
8 个章节 约 16 分钟阅读 AI 智能生成

事后分析撰写Skill:用无指责模板把每一次故障变成组织能力

  • 它是什么:一个专注于「无指责事后分析(Blameless Postmortem)」的 AI 技能,内置标准事后报告模板、5 Whys 根因分析模板、轻量快速模板、会议促进指南与反模式清单。
  • 解决什么问题:故障复盘经常写成「追责文档」或「流水账」,导致信息被隐藏、根因停留在表层、行动项无人跟进。这个技能把复盘流程标准化、结构化。
  • 怎么用:安装启用后,把事件时间线、影响范围、涉及服务告诉它,即可产出一份可直接评审的事后报告初稿。
  • 谁适合用:SRE 与值班工程师、研发负责人、技术主管、QA、平台工程团队,以及正在建立「学习型组织」文化的初创团队。
  • 核心价值:把「事后 3 小时手写文档」压缩到「十几分钟出初稿 + 半小时评审」,同时让复盘结论真正落到可追踪的行动项上。

该技能叫什么?如何一键安装 AI 技能提升开发效率?

基本信息

项目 内容
技能中文名 事后分析撰写Skill
技能英文名 postmortem-writing
技能ID 13232
核心定位 撰写有效、无指责的事后报告,包含根因分析、时间线与行动项

它要解决的问题

故障发生后,团队往往陷入三种典型困境:

  1. 不想写:文档耗时长,值班工程师刚处理完事故,再写几千字复盘,积极性很低。
  2. 写不对:写成「某某操作失误导致故障」,变成追责材料,后续没人愿意主动上报问题。
  3. 写了没用:只有描述没有根因,只有根因没有负责人和截止日期,行动项最终全部烂尾。

事后分析撰写Skill 的思路是:把业界成熟的事后分析方法论(无指责文化、触发条件、时间线复盘、5 Whys、行动项跟踪、反模式规避)固化成一套 AI 可直接调用的结构化模板库,让「写复盘」从创作任务变成填空任务。

一键安装的思路与步骤

说明:以下为通用安装流程。该技能的具体安装命令、入口地址与账号要求,请以官方技能市场/平台说明为准。

  1. 确认安装前提
    • 你使用的 AI 助手或技能平台支持「技能(Skill)」扩展机制;
    • 已完成账号登录,并具备该技能的可见权限(部分团队技能按组织授权开放);
    • 建议同时准备好团队现有的事件等级定义(如 SEV1/SEV2/SEV3)与工单系统命名规范,方便技能输出对齐。
  2. 找到技能
    • 在技能市场的搜索框中输入技能ID 13232,或输入英文名 postmortem-writing、中文名「事后分析撰写」进行检索;
    • 在结果中核对描述是否为「撰写有效、无指责的事后报告,包括根因分析、时间线和行动项」。
  3. 一键安装/启用
    • 点击安装或启用按钮,按平台提示完成授权;
    • 若平台支持「技能开关」,请确认该技能处于已启用状态。
  4. 验证是否生效
    • 新开一个对话,输入类似「我们昨天发生了一次 47 分钟的支付服务故障,帮我起草一份无指责事后分析」;
    • 若技能生效,回复应体现出无指责框架:出现执行摘要、UTC 时间线、根因分析(含 5 Whys 或贡献因素)、检测/响应/影响分段、行动项表格等结构;
    • 如果回复只是泛泛而谈、没有结构化模板,说明技能未启用,请回到第 3 步检查。

为什么「一键安装」能提升开发效率:复盘方法论本身不难,难的是每次都要重新回忆模板结构、重新组织语言、重新检查是否写了指责性表述。技能把这些「隐性规范」前置固化,工程师只需提供事实,省掉的是最耗神的组织与措辞环节。

该技能的主要功能和特点

  • 三种粒度的报告模板,覆盖大小事件
    • 标准事后分析模板:面向 SEV1/SEV2 等重大事件,包含执行摘要、时间线、根因分析、检测、响应、影响、经验教训、行动项、附录全套结构;
    • 5 Whys 分析模板:用连续追问「为什么」的方式逐层下钻,并要求每一步附带证据,避免「靠猜」定根因;
    • 快速事后分析模板:面向 SEV3 等轻微事件,几百字说清「发生了什么、时间线、根因、修复、经验」,避免小事件被跳过。
  • 内置无指责文化准则 技能自带「指责导向 vs 无指责」对照表,例如把「谁导致了这个问题?」改写为「什么条件允许了这个问题发生?」,把「某人犯了错误」改写为「系统允许了这个错误」,从措辞层面阻断追责倾向。
  • 明确的事后分析触发条件 列出了应启动复盘的典型场景:SEV1 或 SEV2 事件、面向客户的停机时间超过 15 分钟、数据丢失或安全事件、可能严重的未遂事件、新的故障模式、需要异常干预的事件。这让「要不要写复盘」不再靠拍脑袋。
  • 完整的复盘节奏时间线 第 0 天事件发生 → 第 1-2 天起草文档 → 第 3-5 天召开事后会议 → 第 5-7 天定稿并创建工单 → 第 2 周及以后完成行动项 → 每季度回顾跨事件模式。技能会按这个节奏提醒你产出对应阶段的文档。
  • 会议促进指南 提供 60 分钟事后会议的标准结构:开场 5 分钟重申无指责文化、时间线回顾 15 分钟、分析讨论 20 分钟、行动项 15 分钟、收尾 5 分钟,并附「把指责转向系统」「鼓励安静参与者」「记录不同意见」等促进技巧。
  • 反模式清单 直接点名五种常见失败模式:指责游戏、浅层分析、无行动项、不切实际的行动、无跟进,并给出更好的替代做法。
  • 与普通文档模板的差异 普通模板只给你一个空壳;这个技能会主动检查你的输入是否缺少关键要素(比如时间线缺时间戳、根因只有一句话、行动项没有负责人),并按模板补齐结构。

如何使用该技能?

步骤 1:判断是否需要复盘

先用技能给出的触发条件自我判断:属于 SEV1/SEV2、客户侧停机超过 15 分钟、数据丢失或安全事件、未遂但可能严重的事件,都应当启动事后分析。轻微事件则可选快速模板。

步骤 2:准备好事实素材

不需要写成文章,只需要把原始信息丢给技能即可,建议包含:

  • 事件标题与日期;
  • 事件严重级别与持续时长;
  • 影响范围(受影响客户数、订单/请求量、收入影响、工单量等);
  • 关键时间点(尽量用 UTC,精确到分钟);
  • 涉及的服务、部署版本或配置变更;
  • 已采取的止损措施。

步骤 3:选择合适的模板发起请求

可以直接用自然语言说明模板偏好,例如:

「这是一次 SEV2 事件,持续 47 分钟,影响约 12000 名客户的支付。请用标准事后分析模板帮我起草,时间线部分我会补充,请先留出 UTC 时间表格结构。」

或者对轻微事件说:

「缓存刷新导致 12 分钟延迟飙升,帮我写一份快速事后分析。」

步骤 4:按技能建议补充根因分析

技能会引导你做 5 Whys,并要求每一步都有证据支撑。你可以逐条回答:

  • 为什么服务失败?→ 数据库连接耗尽(证据:连接数 100/100,500+ 待处理请求);
  • 为什么连接耗尽?→ 每个请求都新建连接而非复用连接池;
  • 为什么绕过连接池?→ 重构时替换了连接获取方式;
  • 为什么代码评审没发现?→ 评审聚焦业务逻辑,忽略基础设施变更;
  • 为什么没有安全网?→ 缺少连接池行为的自动化测试,也缺少相关文档。

技能会把这些整理成「主要根因 / 次要根因 / 第三层根因」,并对应到「预防 / 检测 / 缓解」三类系统性改进。

步骤 5:生成并校验行动项

技能输出的行动项以表格形式呈现,至少包含:优先级(P0/P1/P2)、行动描述、负责人、截止日期、关联工单号。你需要检查三点:有没有孤儿行动项(无负责人)、截止日期是否可达成、是否为凑数而产生的无意义任务。

步骤 6:定稿并分享

按技能建议将文档状态标记为「草稿 / 审核中 / 终稿」,在团队内广泛分享,并在工单系统中跟踪行动项完成情况。技能还建议每季度做一次跨事件模式回顾,把多次复盘中反复出现的根因合并治理。

输出效果说明:技能产出的是一份结构完整的中文初稿,包含执行摘要、时间线表格、根因分析、检测与响应评估(什么奏效 / 什么未奏效 / 差距在哪里)、影响评估、经验教训(做得好 / 做得不好 / 哪里幸运)、行动项表格与附录位置。你只需做事实核对与细节补充,而不是从零写作。

同类型竞品对比分析

方案名称 定位 核心功能 安装/使用门槛 适用场景 优势与不足
事后分析撰写Skill(本技能) 内嵌在 AI 助手里的复盘方法论技能 三套报告模板、5 Whys 分析、无指责措辞规范、会议促进指南、反模式清单、行动项表格 在技能市场按技能ID或英文名检索后一键启用,无额外系统对接;具体入口以官方说明为准 希望快速产出规范复盘文档、又不想引入新系统的团队 优势:开箱即用、方法论完整、强调无指责与行动项闭环;不足:不负责工单系统自动同步与数据采集,需人工搬运事实
通用大模型直接对话 不做技能封装的裸模型对话 可按要求写任意文本,包括复盘 零门槛,直接提问 临时、非标准化的一次性文档 优势:灵活、无学习成本;不足:模板一致性差,容易写成追责口吻或泛泛而谈,每次都要重新交代方法论
商业事件管理平台的事后分析模块 与告警、值班、事件响应打通的一体化 SaaS 自动拉取事件时间线、参与人、告警记录,生成复盘文档并可关联工单 需接入告警源与值班体系,属于组织级采购与部署,价格与接入方式以官方说明为准 已有成熟 SRE 体系、需要数据自动沉淀的中大型团队 优势:数据自动采集、与响应流程深度绑定;不足:接入成本高,模板自定义受产品限制,方法论输出偏流程化
协作文档平台的复盘模板 通用文档工具中的手工模板 提供标题结构与空白表格 复制模板即可使用 小团队、低频复盘 优势:免费、熟悉、可自由编辑;不足:全靠人工填写,无根因引导、无措辞纠偏、无行动项校验

选择建议:如果团队还没有事件管理平台,本技能是最低成本的「方法论补齐」方案;如果已有成熟事件平台但复盘质量不稳定,可以把本技能当作「写作与评审环节的补充」,用它来校对报告结构是否完整、措辞是否滑向指责。

该技能的典型应用场景与实际体验情况

场景一:SRE 值班工程师的深夜事故复盘

  • 角色与痛点:值班工程师刚处理完一次 SEV2 故障,第二天还要写复盘文档,但记忆在快速消退,写出来的时间线常常缺漏关键节点。
  • 使用方式:事故结束后立刻把告警时间、介入时间、回滚时间等原始记录丢给技能,让它生成时间线表格骨架,再逐条核对补全。
  • 实际体验:上手难度低,几乎不需要学习成本,只要会描述事件即可。效果上最明显的是时间线不再是流水账,而是每一条都有明确时间戳与动作。注意事项:技能只能整理你提供的事实,不会自动知道你系统里发生了什么,因此「当天就记录」比「一周后补记」重要得多。

场景二:研发负责人的根因下钻与责任边界把控

  • 角色与痛点:复盘会上容易演变成「谁改的代码」,讨论跑偏,真正的系统性原因被掩盖。
  • 使用方式:用 5 Whys 模板逐层追问,并要求每条结论附证据。技能会把最终根因收敛到系统性层面,例如「缺少基础设施行为的自动化测试」「架构模式文档不足」「评审清单未覆盖基础设施考虑」。
  • 实际体验:技能生成的措辞天然规避点名,讨论焦点从人转到系统,会议氛围明显缓和。注意事项:5 Whys 的每一步都需要真实证据支撑,否则会变成「猜五层」,建议提前准备好指标截图与变更记录。

场景三:技术主管推动行动项闭环

  • 角色与痛点:复盘写完了,行动项列了几条,但三个月后回看,一半没做,也没人记得。
  • 使用方式:让技能按优先级(P0/P1/P2)输出行动项表格,强制包含负责人、截止日期、工单号三列,并按「预防 / 检测 / 缓解」分类。
  • 实际体验:因为表格结构强制要求填负责人,孤儿行动项无处藏身;配合技能的「不要跳过跟进」最佳实践,可以在下次复盘时逐条核对。注意事项:行动项范围要控制在可完成量级,技能的反模式清单里明确提醒「不切实际的行动」等于没写。

场景四:初创团队的复盘文化建设

  • 角色与痛点:团队规模小,没有专职 SRE,也没有事件管理平台,故障靠口头同步,经验难以沉淀。
  • 使用方式:用快速事后分析模板记录轻微事件,用标准模板记录重大事件,配合技能提供的 60 分钟会议结构组织复盘会。
  • 实际体验:不需要采购任何系统,就能把「每次故障都值得记录」的习惯建立起来。技能的季度跨事件回顾建议,还能帮助团队发现反复出现的同类问题。注意事项:轻微事件不要因为「太小」而跳过,技能明确把「跳过小事件」列为反模式——小事件往往揭示模式。

该技能能为用户带来的价值

效率层面:把一份完整事后报告从「几小时的写作 + 多次返工」压缩到「十几分钟产出结构完整的初稿 + 半小时评审补充」。尤其对时间线整理、影响评估分段、行动项表格这些机械性结构工作,节省最明显。若按每次复盘节省 2-3 小时计算,一个季度十次事件就是 20-30 小时的工程时间回归到修复与预防工作上。

质量层面:报告结构的一致性显著提升。有了固定模板,管理层可以快速定位「影响有多大、根因是什么、谁在什么时候完成什么」,不再需要每次适应不同的文档风格。5 Whys 的证据要求也把根因从「人为失误」这类无效结论推向「系统缺少什么保护」。

文化层面:无指责措辞规范的意义超出文档本身。当复盘文档里不出现人名、只出现系统条件时,工程师才敢如实上报未遂事件、承认自己操作过什么。这种心理安全感是组织学习的前提,也是本技能最长期的价值。

管理层面:行动项的优先级 + 负责人 + 截止日期 + 工单号四要素结构,让复盘结论真正进入项目管理视野,而不是停留在文档里。季度跨事件回顾的建议,则为组织提供了从「单次事件改进」升级到「系统性风险治理」的路径。

门槛层面:把需要经验积累的复盘方法论(怎么问、问几层、怎么写不伤人、行动项怎么定)变成可即取即用的模板,让刚入职的工程师也能写出接近资深 SRE 水准的复盘文档。

常见问题 FAQ

Q1:这个技能怎么安装?需要额外付费吗?

在支持技能机制的平台中,通过技能市场搜索技能ID 13232 或英文名 postmortem-writing,点击安装或启用即可,无需改动现有代码仓库或系统。是否需要付费、是否有团队版授权限制,取决于所在平台的计费策略,以官方说明为准。

Q2:它会不会自动读取我们的监控数据、自动生成时间线?

不会。该技能的定位是「撰写与结构化」,它基于你提供的事实来组织报告。时间线、影响数据、告警记录需要你从监控系统、工单系统中导出后粘贴或口述给它。技能的价值在于把零散事实整理成符合复盘规范的文档结构,并提示你哪些要素还缺失。

Q3:适合哪些人用?小团队有必要吗?

最适合 SRE、值班工程师、研发负责人、技术主管、QA 与平台工程团队。小团队反而更值得用:小团队通常没有事件管理平台,也没有专职的复盘推动者,而这个技能把方法论直接送到手边,用最低成本建立「每次故障都有记录、都有行动项」的习惯。

Q4:它和事件管理平台自带的事后分析功能怎么选?

两者不冲突。事件管理平台的优势是数据自动采集与流程打通,适合已有告警与值班体系的中大型团队;本技能的优势是方法论完整、措辞规范严格、零接入成本。实践中常见组合是:平台负责采集事实数据,技能负责把这些数据写成一份结构清晰、无指责、行动项可追踪的报告。若团队规模小、暂无平台,直接用本技能即可满足需求。

Q5:用 AI 写复盘,会不会变成套话、失去真实细节?

有这个风险,但可以通过两点规避:一是输入时提供尽可能具体的事实(精确到分钟的时间戳、具体指标数值、具体变更版本号),技能的模板会把这些事实填进对应位置,而非生成空泛描述;二是把技能输出当作初稿,由事件参与者补充「什么奏效、什么未奏效、哪里幸运」这类只有亲历者才知道的细节。技能的 5 Whys 模板强制要求每一步附证据,本身就是在防止套话。