sre-postmortem — скилл для Claude Code: что делает и как установить
Скилл sre-postmortem для Claude Code помогает составлять и проверять безанкерные постмортемы по методологии Google SRE. Он убирает обвинительные формулировки и формулирует задачи на исправление систем.
Apache-2.0 ★ 67 обновлён 2026-10-22
npx skills add paulip114/sre-practice-skills --skill sre-postmortem -a claude-codeЧто делает sre-postmortem
Скилл задаёт структуру отчёта об инциденте, правила анализа причин и критерии для задач по итогам сбоя. Инструкция требует разделять прямой триггер и системные причины вроде отсутствия лимитов или ошибок в проверках. Текст инцидента очищается от эмоциональных оценок и перехода на личности, переводя разбор на поведение компонентов и пробелы в автоматизации.
Внутрь заложены требования к задачам: обязательный владелец, приоритет и проверяемый результат вместо размытых обещаний. Шаблон references/postmortem-template.md и чеклист ревью помогают проверить хронологию в UTC, оценку ущерба в цифрах и распределение задач по типам: предотвращение, сглаживание последствий и детекция.
Для работы скилла не нужны ключи API или внешние сервисы. Достаточно добавить файл разметки в каталог навыков поддерживаемого ассистента.
Какие задачи решает
- оформить безанкерный отчёт об аварии по стандарту Google SRE
- убрать из описания инцидента обвинения сотрудников и эмоциональные фразы
- разделить триггер инцидента и скрытые первопричины сбоя
- составить проверяемые задачи по предотвращению повторных инцидентов
- проверить готовый черновик постмортема по контрольному чеклисту
Примеры запросов агенту
- Проверь черновик постмортема postmortem.md и найди обвинительные формулировки
- Помоги переписать задачи по итогам инцидента так, чтобы у каждой был проверяемый критерий готовности
- Оформи хронологию сбоя и посчитай ущерб по логам из incident-notes.txt
Как установить sre-postmortem
1Через Skills CLI (Vercel)
npx skills add paulip114/sre-practice-skills --skill sre-postmortem -a claude-code2Вручную: положить файлы
~/.claude/skills/sre-postmortem/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/sre-postmortem/
1Через Skills CLI (Vercel)
npx skills add paulip114/sre-practice-skills --skill sre-postmortem -a codex2Вручную: положить файлы
.agents/skills/sre-postmortem/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add paulip114/sre-practice-skills --skill sre-postmortem -a cursor2Вручную: положить файлы
.cursor/skills/sre-postmortem/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install paulip114/sre-practice-skills sre-postmortem2Вручную: положить файлы
.github/skills/sre-postmortem/SKILL.md1Через Skills CLI (Vercel)
npx skills add paulip114/sre-practice-skills --skill sre-postmortem -a gemini-cli2Командой платформы
gemini skills install https://github.com/paulip114/sre-practice-skills --path sre-postmortemВручную: положить файлы
.devin/skills/sre-postmortem/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о sre-postmortem
Как установить sre-postmortem в Claude Code?
Выполните команду npx skills add paulip114/sre-practice-skills --skill sre-postmortem -a claude-code в терминале или сохраните спецификацию в файл ~/.claude/skills/sre-postmortem/SKILL.md.
Что делает скилл sre-postmortem?
Он направляет ИИ при составлении разборов инцидентов: помогает составить таймлайн в UTC, отделить повод от системных причин и превратить выводы в конкретные тикеты.
Какие критерии скилл предъявляет к задачам по итогам инцидента?
Каждая задача должна иметь одного ответственного, тикет в трекере, понятный приоритет и проверяемый результат. Скилл следит за балансом между предотвращением, устранением и детекцией.
Исходный текст
SKILL.md · Apache-2.0
---
name: sre-postmortem
description: Use when writing, reviewing or improving a blameless postmortem — structuring the document, quantifying impact, separating trigger from root causes, writing concrete action items, removing blameful language, or building postmortem culture and follow-up tracking. Based on Google SRE practice.
---
# Blameless Postmortems
A postmortem is a written record of an incident: its impact, what was done, its root causes and contributing factors, and the follow-up that prevents recurrence. Its value is proportional to what people learn from it and what changes because of it.
## When one is required
Agree triggers in advance. Typical:
- User-visible downtime or degradation beyond a threshold.
- Data loss of any kind.
- On-call intervention such as a rollback or traffic reroute.
- Resolution time above a threshold.
- Monitoring failure (humans found it, not alerts).
- A single incident consuming a large share of error budget (per `sre-slos-and-error-budgets`).
- Anyone may request one for any event.
## Blamelessness
Assume everyone acted reasonably with the information and tools they had. Focus on **what** in the system allowed the failure, not **who**.
- Don't name individuals as the cause; describe the action and the conditions that made it possible ("the workflow was rerun manually; the tool had no guard against repeat execution").
- No loaded or emotional language ("careless", "ridiculous", "can't believe we survived"). Replace adjectives with data.
- Action items fix systems and processes, not people. "Train people to be more careful" is not a fix; a guard rail is.
- If leadership slips into blame, redirect to "what warning signs existed and why were they missed?"
## Procedure
1. **Assign one owner** (plus collaborators) as soon as the incident closes. Include everyone who participated in writing it.
2. **Pull the facts** from the incident state doc, chat logs, graphs, deploy history. Build the timeline in UTC.
3. **Quantify impact** with numbers: duration, affected users/requests/% of traffic, latency, revenue/budget impact, team cost. An estimate with its method stated beats no number.
4. **Analyse causes.** Separate the **trigger** (what set it off) from **root causes and contributing factors** (latent conditions that let the trigger cause damage — missing validation, no rate limit, unsafe default, monitoring gap). Keep asking why until you reach things you can change. Expect several contributing causes.
5. **Lessons learned**: what went well, what went poorly, where we got lucky (luck marks a hidden risk).
6. **Action items** — see criteria below. Group them by theme for large incidents.
7. **Review** with the checklist below; senior engineers review high-impact postmortems.
8. **Publish within about a week**, widely by default (whole engineering org; customers when appropriate). Delay lets memory fade and lets others fill the silence.
9. **Track action items to closure** in the normal bug tracker and review completion rates.
Template: `references/postmortem-template.md`.
## Action item criteria
Each action item must have:
- **One owner** and a **tracking ticket**.
- A **priority** — not all the same. At least one top-priority item for any user-affecting outage.
- A **verifiable end state**: "Alert when > X% of machines leave the pool within 10 min", not "improve alerting".
- A **type**, with a balance across types — not only mitigations:
- *Prevent* — stop this class from happening (input validation, safety checks, idempotency).
- *Mitigate* — reduce blast radius or duration (rate limits, kill switch, smaller rollouts).
- *Detect* — find it sooner (new alert, probe).
- *Repair / Investigate / Process* as needed.
## Review checklist
- [ ] Readable by someone outside the team (background + glossary for jargon)?
- [ ] Impact quantified, with sources linked?
- [ ] Trigger and root causes both identified, at sufficient depth?
- [ ] Timeline complete, with detection and mitigation times?
- [ ] Action items meet the criteria above, vetted by the service's tech lead?
- [ ] Blameless language throughout?
- [ ] Single owner, status, dates, sharing list filled in?
- [ ] Shared beyond the team?
## Building the culture
- Reward closing action items, not just writing documents.
- Celebrate good postmortems (reading clubs, weekly outage summaries, cross-team reviews).
- Use past postmortems for training (re-enact them as role-play drills).
- Add machine-readable metadata (services, trigger type, detection method, durations) so trends can be analysed across postmortems.
- Warning signs: people avoid being "involved", postmortems are late or shallow, the same incident recurs (are action items closing? is velocity trumping fixes?).
## Sources
- SRE book ch. 15 Postmortem Culture — https://sre.google/sre-book/postmortem-culture/
- SRE book Appendix D Example Postmortem — https://sre.google/sre-book/example-postmortem/
- SRE book ch. 16 Tracking Outages — https://sre.google/sre-book/tracking-outages/
- Workbook ch. 10 Postmortem Culture — https://sre.google/workbook/postmortem-culture/
- Workbook Appendix C Results of Postmortem Analysis — https://sre.google/workbook/postmortem-analysis/
© paulip114 · Apache-2.0 · paulip114/sre-practice-skills