一份优秀的事故复盘报告属于技术写作范畴。它应当让未亲历现场的人也能读懂，清晰地传达时间线，并提出具体的改进措施。
大多数复盘报告都未能做到这些。它们只是一堆斯拉克（Slack）截图的堆砌。
以下是撰写人们愿意阅读的复盘报告的方法。
结构
1. 摘要（3 句话）。发生了什么。影响范围。持续时间。仅此而已。
2. 时间线。精确的时间点，使用协调世界时（UTC）。不要写“下午 3 点左右”，而要写“14:02 UTC”。每个事件占一行。
3. 影响。量化描述。“14:02 至 14:17 期间，X% 的结账流量失败。”而不是“部分用户受到影响”。
4. 根本原因。什么出了问题以及为什么出问题。不要追究是谁的问题。如果答案是“人为错误”，请继续深入追问——为什么系统允许人为错误进入生产环境？
5. 行动项。具体明确。责任人。截止日期。“在配置流水线中添加验证 — @爱丽丝 — 2 周内。”而不是“更加小心”。
语气
写作时要像是在向一位好奇的外行解释。不要使用内部笑话。不要说“众所周知”。未来的读者并不知道这些背景。
保持诚实。如果原因令人尴尬，也要如实记录。掩盖丑陋部分的复盘报告对读者毫无价值。
分发
最好的复盘报告会被团队以外的人阅读。分享它们。将它们存入可搜索的档案库。在设计评审中引用它们。（“我们在 2024 年尝试过这个方法，参见第 42 号复盘报告。”）
组织记忆存在于优秀的复盘报告中。糟糕的复盘报告在撰写当天就会被人遗忘。
作者：萨姆森·塔尼马沃博士
理学学士 · 理学硕士 · 工商管理硕士 · 哲学博士
创始人兼首席执行官，诺瓦人工智能运维公司。 https://novaaiops.com
免责声明：本文内容来自互联网，该文观点不代表本站观点。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容，请到页面底部单击反馈，一经查实，本站将立刻删除。
