← 中文资源

简体中文版本

添加无责复盘模板

提供包含时间线、贡献因素与责任到人的行动项的复盘模板,并在 CI 中强制检查必需章节。

阅读英文原文

概述

无责复盘关注系统条件而不是个人失误,因为追责会抑制防止问题再次发生所需的信息。这不意味着文档可以松散,反而要求更精确:发生了什么、哪些防线失效、下次用什么具体改动降低概率或影响。

步骤

  1. 在 docs/postmortems/TEMPLATE.md 中添加固定章节,包括影响、时间线、贡献因素和行动项。
  2. 在事件发生期间就创建文件,从聊天记录和告警历史中实时填写时间线:
cp docs/postmortems/TEMPLATE.md docs/postmortems/2026-10-21-payments-latency.md
  1. 在 CI 中检查关键标题和至少一条带负责人与截止日期的行动项:
grep -q '^## Timeline' "$file"
grep -q '^## Action items' "$file"
grep -Eq '^\| [^|]+ \| [^|]+ \| 2026-' "$file"
  1. 每周复盘行动项,只有每项都有工单和负责人才关闭复盘。

验证

预期缺少时间线或行动项的复盘会让 CI 失败并指出文件名;完整文件通过检查。行动项应出现在常规待办系统中,并在周会上有明确的完成、排期或接受风险结论。

注意事项

  • CI 只校验结构,不保证质量,填满模板仍可能缺少洞察。
  • 时间线应包含发现与响应时间,而不只是触发点,检测缓慢往往影响最大。
  • 小型事件不必使用完整模板,应定义需要复盘的严重级别门槛。
  • 贡献因素描述系统条件,例如缺少超时或回滚未演练,避免指向个人。