Postmortem Writing

Use after an incident, near miss, or reliability event to produce a blameless, evidence-grounded postmortem with a timeline, contributing conditions, actions, owners, and follow-up verification.

9 stars 3 forksWriting & Content

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add sandbaseai/workbuddy-skill --skill postmortem-writing
Manual install
git clone --depth 1 https://github.com/sandbaseai/workbuddy-skill.git /tmp/workbuddy-skill
mkdir -p ~/.claude/skills
cp -r /tmp/workbuddy-skill/skills/postmortem-writing ~/.claude/skills/postmortem-writing

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# 事件复盘写作

复盘的目标是改进系统,而不是寻找替罪羊。把事件材料整理成可审阅、可行动、可追踪的学习文档:明确发生了什么、哪些条件共同促成了结果、哪些证据仍缺失,以及如何验证改进确实降低了风险。

## 安全与范围门禁

开始前确认事件编号、时间窗口、读者、授权材料、保留期限和发布范围。默认最小披露:

- 只使用获授权的日志、指标、变更、工单、告警和访谈记录;未知内容标记 `Unknown`,不补写细节;
- 不点名羞辱个人,不把一次操作失误写成个人品格判断,不根据职位或相关性推断责任;
- 报告中脱敏 token、密码、个人信息、客户内容、内部地址、漏洞利用细节和不必要的供应商数据;
- 区分事实、推断、争议和估算;每个高影响结论绑定时间、来源或可复核查询;
- 事件仍在进行时,先服务稳定和安全处置;复盘不得替代值班升级、取证保全或正式事故响应。

证据不足、授权不明、事件尚未稳定或报告目标不清时,返回 `BLOCKED`,先列出缺口和安全的补证动作。

## 复盘工作流

1. **定义影响**:记录开始/结束时间、受影响用户或系统、错误预算/服务目标、数据完整性、恢复方式和置信度;事实与估算分栏。
2. **建立证据账本**:为日志查询、指标面板、变更记录、告警、部署、沟通和工单记录引用编号、时间范围、时区、保存位置和脱敏结果。
3. **重建时间线**:按统一时区排列“发生、发现、判断、缓解、恢复、验证”事件;标出观察间隔、矛盾时间和缺失数据。
4. **描述故障链**:从触发器、系统状态、失效机制、扩大因素到用户影响建立因果假设;避免把相关性直接写成根因。
5. **分析促成条件**:检查设计、依赖、容量、部署、监控、流程、权限、文档和沟通等系统条件;允许多个根因和未知项共存。
6. **记录响应决策**:说明当时已知信息、可选方案、为何选择、结果和未采用方案;不要用事后信息指责当时决策。
7. **生成行动项**:每项行动针对明确风险,指定负责人、截止时间、完成证据、优先级、依赖、回滚/退出条件和复查日期。
8. **进行复盘审阅**:让受影响团队核对事实、隐私和可执行性;异议保留为异议,不强行合并成单一叙述。
9. **验证学习结果**:到期检查测试、告警、演练、变更或指标证据,标记 `Verified`、`Partially Verified`、`Overdue` 或 `Rejected`,并更新残余风险。

## 证据状态与因果纪律

使用下列状态,避免把推测包装成事实:

| 状态 | 含义 |
| --- | --- |
| `Observed` | 可由原始记录直接复核的现象 |
| `Inferred` | 有多个证据支持但仍存在替代解释 |
| `Disputed` | 团队对事实、解释或影响存在分歧 |
| `Unknown` | 当前材料不能可靠回答 |
| `Verified` | 行动或假设已通过约定测试/指标复核 |

“根因”应描述可改变的系统条件,不应停留在“某人犯错”“操作不当”或“缺乏注意力”。如果存在多个必要条件,列出它们的关系;如果只能证明相关性,明确写出尚未证明的因果链。

## 复盘模板
Read the full skill on GitHub

Details

Skill name
postmortem-writing
Path
skills/postmortem-writing/SKILL.md
License
MIT
Repo updated
8 September 2026

FAQ

What does the Postmortem Writing skill do?

Use after an incident, near miss, or reliability event to produce a blameless, evidence-grounded postmortem with a timeline, contributing conditions, actions, owners, and follow-up verification.

How do I install the Postmortem Writing skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add sandbaseai/workbuddy-skill --skill postmortem-writing. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Postmortem Writing popular?

It lives in sandbaseai/workbuddy-skill, which has 9 GitHub stars and 3 forks.

Related skills

Browse the most popular Claude skills, all writing & content skills, or write your own with the skills generator.