К основному содержанию
скилл CX Codex

sre-postmortem — скилл для Claude Code: что делает и как установить

Скилл sre-postmortem для Claude Code помогает составлять и проверять безанкерные постмортемы по методологии Google SRE. Он убирает обвинительные формулировки и формулирует задачи на исправление систем.

Apache-2.0 ★ 67 обновлён 2026-10-22

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add paulip114/sre-practice-skills --skill sre-postmortem -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/sre-postmortem/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/sre-postmortem/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «DevOps и инфраструктура» →
write-a-postmortem Inkeep Скилл write-a-postmortem помогает разобрать сбой и составить отчёт по стандартам Google SRE в папке postmortems/. Он исключает обвинения людей и опирается на факты. CX Codex +1 243установок postmortem-generator Riccardo Carlesso (creator/maintainer) Скилл postmortem-generator для Claude Code собирает постмортем по инциденту: ведёт к таймлайну, action items и черновику Google Doc. Нужны данные расследования и root cause. CX Codex +1 ★ 151звёзд репо postmortem-writer patricio0312rev Скилл postmortem-writer собирает разбор инцидента в готовый документ: таймлайн, корневая причина, задачи с владельцами. Пригодится, пока детали аварии ещё свежи в памяти. CX Codex +1 265установок sre-expert personamanagmentlayer Скилл sre-expert для настройки практик SRE, расчёта SLO и организации процессов инцидент-менеджмента в проекте. CX Codex +1 205установок postmortem-aggregator Riccardo Carlesso Скилл postmortem-aggregator для Claude Code разбирает Post Mortem в папке, рассчитывает показатели сбоев и обновляет POMO_AGGREGATED.md. Помогает находить повторяющиеся причины инцидентов. CX Codex +1 ★ 151звёзд репо incident-postmortem официальный github Скилл incident-postmortem для GitHub Copilot готовит разбор сбоя в формате Google SRE без поиска виноватых. Запускается по просьбе написать постмортем, RCA или отчёт об outage. CX Codex +1 81установок

Из того же набора8

sre-data-reliability Скилл sre-data-reliability для Claude Code помогает проектировать и проверять конвейеры данных, планировщики задач, резервное копирование и восстановление. Он включается при работе с целостностью данных и SRE-практиками. CX Codex +1 ★ 67звёзд репо sre-incident-response Скилл sre-incident-response для Claude Code структурирует действия команды при авариях на проде по практикам Google IMAG. Он задаёт роли, шаблоны сводок и алгоритм быстрой локализации сбоев. CX Codex +1 ★ 67звёзд репо sre-release-and-launch Скилл sre-release-and-launch для Claude Code помогает спланировать выпуск кода и подготовить сервис к запуску. Он подключается при настройке выкатки, анализа canary или проверки production readiness. CX Codex +1 ★ 67звёзд репо sre-monitoring-and-alerting Скилл sre-monitoring-and-alerting для Claude Code проектирует мониторинг и оповещения по практикам Google SRE. Включается при разборе SLO, метрик golden signals и расчёте burn rate. CX Codex +1 ★ 67звёзд репо sre-capacity-and-system-design Скилл sre-capacity-and-system-design для Claude Code помогает проектировать и проверять распределённые системы на масштабирование и устойчивость. Агент подключает его для расчётов ёмкости, балансировки нагрузки и разбора каскадных отказов. CX Codex +1 ★ 67звёзд репо sre-slos-and-error-budgets Скилл sre-slos-and-error-budgets для Claude Code помогает проектировать SLI и SLO по практикам Google SRE. Включается при согласовании error budget policy или оценке инцидентов. CX Codex +1 ★ 67звёзд репо sre-on-call-and-toil Скилл sre-on-call-and-toil для Claude Code помогает проектировать дежурства и снижать операционную нагрузку. Он подключается при настройке ротаций, разборе переработок и поиске задач для автоматизации. CX Codex +1 ★ 67звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой