technical-postmortem SKILL.md skillA

technical-postmortem from webkubor/writing-standard-skills is an agent skill: a SKILL.md folder an AI agent loads when a task calls for it.

Install it, pinned
mdr add webkubor/writing-standard-skills/technical-postmortem@git:20261025.4eaa475

Pins git:20261025.4eaa475 in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 17 of 17 checks passed
Kind
SKILL.md skill
Repository
webkubor/writing-standard-skills
Path
skills/technical-postmortem/SKILL.md
Versions recorded
1
Latest version
git:20261025.4eaa475, committed Oct 25, 2026
Size
8,965 bytes
Repository stars
6
License
MIT

严肃技术故障复盘、事故通报(Postmortem)与对外公关的表达规范。基于防御性工程与无指责复盘(Blameless Postmortem)原则,剔除空洞道歉与甩锅推诿,下钻到机制防线与量化事实。触发:"事故通报 / 写复盘 / postmortem / 线上故障复盘 / 宕机通报 / 故障原因分析 / 为什么挂了 / 事故报告"。.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# 严肃技术故障复盘与事故通报规范

事故复盘与故障通报不是“公关道歉信”,更不是“道德审判与甩锅大会”。**它的唯一目的是:用不可辩驳的客观事实还原真相,把根因锁定在系统机制与物理约束的缺失上,并给出一经部署就不可绕过的物理防复发措施。**

判断一份事故报告是否合格的唯一标准:**读完之后,用户和工程师是觉得“这家公司在遮遮掩掩推卸责任”,还是清楚地知道“系统在哪个物理环节断了、这次教训换来了什么永久防线”?**

---

## 零、事故通报六步骨架(The Postmortem Skeleton)

动笔撰写故障通报或技术复盘前,按此骨架填空,不缺步、不跳步:

```
① 首屏摘要   故障定级 · 影响范围(受损比例/脏数据行数/时长) · 核心根因一句话
② 时间线     UTC 时间戳驱动 · 状态变化 · 发现/止血/根治的客观动作(零修辞)
③ 根因下钻   5 Whys 机制下钻 · 归因于机制缺失,绝不下钻到“某员工疏忽”
④ 止血处置   当时采取的应急措施 · 恢复线上可用的临时绕行方案
⑤ 永久防线   Action Items · 谁主责 · 何时上线 · 依赖的物理门禁/代码约束
⑥ 外部证据   监控图表 · 日志指纹 · Git Commit SHA · 外部健康探测回执
```

---

## 一、🚫 事故通报四大禁忌(Anti-PR Blacklist)

任何准备发给用户、客户或管理层的事故通报,严禁出现以下“公关八股”:

| 违规表述 | 为什么令人极其反感 | 工业级替代方案 |
|---|---|---|
| **“给您带来的不便敬请谅解”** | 万能无意义套话,用户受损时听到这话只觉冷漠与傲慢。 | 删掉!直接陈述补偿方案或已就绪的恢复动作(“受影响账单已全额回退,补偿配额已到账”)。 |
| **“我们将深刻吸取教训,举一反三”** | 语言的巨人、行动的矮子。没有任何工程落点。 | 给出代码级约束(“代码已引入 pre-commit 语法门禁,同类配置错误将在提交时被直接拒绝”)。 |
| **“由于某工程师操作不当 / 某同事失误”** | 把系统性漏洞甩给个人,暴露团队工程素养极差。 | 归因于防护机制缺失(“系统缺乏操作二次确认与沙箱隔离栅栏,允许未经验证的脚本直连了生产库”)。 |
| **“极少数用户受到轻微影响”** | 掩耳盗铃、试图粉饰太平,被抓出真实数据直接信誉破产。 | 给出精确客观数字(“共影响 142 个并发请求(占同时段总流量的 0.18%),持续 14 分钟”)。 |

---

## 二、关键段落表达规范

### 1. 影响面量化(Impact Scope)
- **绝不使用模糊字眼**:禁止写“部分用户”、“短时间”、“个别接口”。
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add webkubor/writing-standard-skills/technical-postmortem@sha256:82ee31da26f6613b

The line at the top of this page pins the label git:20261025.4eaa475, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_m7h7u35drf2537sg.svg)](https://markdownregistry.com/a/art_m7h7u35drf2537sg)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 1 version of this file, committed on Oct 25, 2026.

versioncommittedcommitsizeaudit
git:20261025.4eaa475 latest2026-10-25 4eaa475 8,965 BA view

Audit of the latest version

A  17 of 17 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Frontmatter block present
  • pass: Frontmatter declares a name
  • pass: Frontmatter declares a description
  • pass: Size between 200 bytes and 200 KB (8965 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

webkubor/writing-standard-skills · 6 stars · license MIT · pushed 2026-11-06 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_m7h7u35drf2537sg
GET https://markdownregistry.com/api/v1/resolve?ref=webkubor/writing-standard-skills/technical-postmortem
GET https://markdownregistry.com/api/v1/blob/82ee31da26f6613b0b58efc1e5ab8dad00df9fb9a2d9810c5742993951c40a12

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: the SKILL.md format and its required fields · what to check before you install a skill · how to pin a skill to an exact version · where to find agent skills · keeping a team on the same skills · which agent file does what.

More from webkubor/writing-standard-skills

AGENTS.md AGENTS.md file
webkubor/writing-standard-skills · AGENTS.md
git:20261025.4eaa475 · audit B · 6 stars
llms.txt llms.txt file
webkubor/writing-standard-skills · llms.txt
git:20261025.6457abe · audit A · 6 stars
account-custody SKILL.md skill
webkubor/writing-standard-skills · skills/account-custody/SKILL.md · 「账户托管运营前置检查」——Agent 替人接管社交账户(发帖/回复/互动)之前,必须先完成四件事:核对当前平台与入口、加载平台规则红线、读出该账户已有人设与口吻、确认出口 IP…
git:20261105.3275eed · audit A · 6 stars
decision-and-rfc SKILL.md skill
webkubor/writing-standard-skills · skills/decision-and-rfc/SKILL.md · 架构决策记录(ADR)、技术提案(RFC)与重大方案论证的表达规范。基于第一性原理、权衡对齐(Trade-offs)与可证伪性。拒绝报喜不报忧,要求显式声明放弃的代价与推翻条件。触发:"写方案 / 架构决策 / ADR / RFC /…
git:20261025.4eaa475 · audit A · 6 stars
executive-briefing SKILL.md skill
webkubor/writing-standard-skills · skills/executive-briefing/SKILL.md · 面向业务负责人、决策者与 owner 的极简汇报与卡单拍板规范。基于低成本沟通(reply-format-low-cost)与终点导向运行模型。严禁倒苦水铺垫过程,将开放性提问收敛为互斥选项的代价对齐。触发:"对上汇报 / 给老板汇报 /…
git:20261025.4eaa475 · audit A · 6 stars
how-to-write SKILL.md skill
webkubor/writing-standard-skills · skills/how-to-write/SKILL.md · 「怎么写文字」的总纲——先按金字塔原理搭骨架(结论先行 / SCQA / MECE),再按读者定语气(人还是 agent、上级还是同侧),最后必须以新读者身份通读自检。管一切要给别人看的文字:文档、单据、报告、评审意见、讲稿、群消息、PR…
git:20261025.fb9d7b8 · audit A · 6 stars
peer-facing-writing SKILL.md skill
webkubor/writing-standard-skills · skills/peer-facing-writing/SKILL.md · 写给同事看的文本(GitLab 单据、飞书文档、评审意见、群消息、PR review、跨团队报告)的语气与结构规范,基于职场协作与社会心理学。触发:"提单 / 写报告 / 写文档给 QA 或后端 / 评审意见 / 回评 / 跨团队沟通 /…
git:20260910.b68d609 · audit A · 6 stars
platform-voices SKILL.md skill
webkubor/writing-standard-skills · skills/platform-voices/SKILL.md · 「全平台表达风格与媒介心智」分册——按平台受众的心理账户匹配表达法则。涵盖网易云音乐(情怀/通感/夜读)、小红书(大情绪击穿/生活口语/高CTR)、Twitter/X(独立极客/反常识/短平快)、Reddit(零营销耐受/真实硬核/TL;D…
git:20261106.94b7d41 · audit A · 6 stars
scenario-openers SKILL.md skill
webkubor/writing-standard-skills · skills/scenario-openers/SKILL.md · 「场景接待词、破冰与开场钩子库」分册——彻底剔除AI味,像真人一样在各种具体场合下开口。提供私信接待、客诉安抚、社区Issue回应、网易云神评开场、小红书大情绪钩子、X极客直击钩子等高细粒度原子语料。拒绝空洞升华与机器套话,追求真实的人味、…
git:20260926.5283a19 · audit A · 6 stars
talk-text-review SKILL.md skill
webkubor/writing-standard-skills · skills/talk-text-review/SKILL.md · 讲稿/分享稿的文本验收——查的不是错别字,是**姿态**:这份稿子读起来是「我教你们」还是「我跟你们聊」。用心理逆反、自我暴露、认识论谦逊这几条机制,逐句找出会把听众推到对立面的表达并给出改写。触发词:讲稿验收、分享稿检查、这么讲会不会得罪…
v1.0.0 · audit A · 6 stars
talk-visual-review SKILL.md skill
webkubor/writing-standard-skills · skills/talk-visual-review/SKILL.md · 演讲页/幻灯片的视觉验收——用浏览器实测每一屏是否被切、是否过空、对比度够不够、色板有没有绕过主题变量,而不是靠肉眼翻页目测。触发词:讲稿排版检查、幻灯片验收、内容溢出、投影看不全、slide 被切、演讲页视觉检查、talk…
v1.0.0 · audit A · 6 stars

Every file in webkubor/writing-standard-skills

Browse by kind, by grade A, or by owner.