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

postmortem-writer — скилл для Claude Code: постмортем инцидента

Скилл postmortem-writer собирает разбор инцидента в готовый документ: таймлайн, корневая причина, задачи с владельцами. Пригодится, пока детали аварии ещё свежи в памяти.

MIT 265 установок ★ 64 обновлён 2026-01-12

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

Что делает postmortem-writer

Скилл пишет постмортем на Markdown: сводка, влияние в цифрах, таймлайн, корневая причина с диффом кода, способствующие факторы, что прошло хорошо и что нет, задачи с владельцами и сроками, выводы и приложение.

Внутри лежит готовый разбор падения API из-за исчерпанного пула соединений к базе: с отметками времени, таблицей задач и статусами. Отдельным блоком идут правила blameless-разбора — смотреть на системы и процессы, людей не трогать. Графики мониторинга, лог коммуникаций с клиентами и ссылка на PR с фиксом в приложении остаются плейсхолдерами в квадратных скобках: скилл оформляет документ, телеметрию он не читает.

Цифры в разделе Impact и точность таймлайна зависят от того, что вы дадите агенту. Без отметок времени и числа затронутых пользователей останутся общие формулировки. В конце шаблона — чек-лист: встреча проведена, документ разослан, follow-up назначен.

Какие задачи решает

  • собрать таймлайн аварии по минутам
  • найти корневую причину и не свалить её на дежурного
  • разложить задачи по владельцам и срокам
  • зафиксировать, что сработало во время сбоя
  • проверить черновик разбора по чек-листу

Примеры запросов агенту

  • Собери постмортем по вчерашнему падению API: таймлайн с 14:15 до 14:57 UTC, корневая причина — утечка соединений в v2.3.4.
  • Оформи blameless-разбор инцидента: что сработало, что нет и какие задачи завести с владельцами и сроками.
  • Проверь черновик постмортема по чек-листу и перечисли, что осталось сделать после встречи.

Как установить postmortem-writer

1Через Skills CLI (Vercel)

npx skills add patricio0312rev/skills --skill postmortem-writer -a claude-code

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

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

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о postmortem-writer

Как установить postmortem-writer в Claude Code?

Выполните npx skills add patricio0312rev/skills --skill postmortem-writer -a claude-code. Файл скилла появится по пути ~/.claude/skills/postmortem-writer/SKILL.md.

Что делает postmortem-writer?

Собирает документ по инциденту: сводку, влияние, таймлайн, корневую причину, способствующие факторы и задачи с ответственными.

Разбор получается blameless?

Да, в скилле есть блок правил: разбирать системы и процессы, а не людей и команды. Он же просит не прятать инцидент и не оставлять задачи без владельца.

Исходный текст

SKILL.md · MIT
---
name: postmortem-writer
description: Creates comprehensive post-incident documents with timeline, root cause analysis, contributing factors, action items, and ownership. Follows SRE best practices for blameless postmortems. Use for "postmortem", "incident review", "RCA", or "post-incident".
---

# Postmortem Writer

Document incidents for learning and improvement.

## Postmortem Template

```markdown
# Postmortem: API Outage - Database Connection Pool Exhausted

**Date:** 2024-01-15
**Authors:** Jane Doe (On-call), John Smith (DBA)
**Status:** Complete
**Severity:** P1 (Critical)

## Summary

On January 15, 2024, our API experienced a complete outage for 25 minutes (14:32 - 14:57 UTC) affecting 100% of users. The root cause was database connection pool exhaustion triggered by a connection leak introduced in deployment v2.3.4.

**Impact:**

- Duration: 25 minutes
- Users affected: ~50,000
- Requests failed: ~125,000
- Revenue impact: ~$15,000

## Timeline (All times UTC)

| Time  | Event                                            |
| ----- | ------------------------------------------------ |
| 14:15 | v2.3.4 deployed to production                    |
| 14:32 | First CloudWatch alarm: HighErrorRate            |
| 14:33 | PagerDuty alert sent to on-call (Jane)           |
| 14:35 | Jane acknowledges, begins investigation          |
| 14:38 | Identified: Database connection pool at 100%     |
| 14:40 | Attempted: Kill long-running queries (no effect) |
| 14:43 | Decision: Rollback to v2.3.3                     |
| 14:45 | Rollback initiated                               |
| 14:47 | Rollback complete, connections dropping          |
| 14:50 | Error rate returning to normal                   |
| 14:57 | All systems recovered, incident closed           |
| 15:30 | Postmortem meeting scheduled                     |

## Root Cause

A code change in v2.3.4 introduced a connection leak in the user profile endpoint. The new caching layer was not properly releasing database connections after queries completed.

**Code diff:**
\`\`\`diff

- await prisma.user.findUnique({ where: { id } });

* const client = await pool.connect();
* const user = await client.query('SELECT \* FROM users WHERE id = $1', [id]);
* // Missing: client.release() ❌
  \`\`\`

## Contributing Factors

1. **Insufficient testing:** Load tests didn't catch the leak

   - Tests only ran for 5 minutes
   - Not enough concurrent connections to exhaust pool

2. **Missing monitoring:** No alerts on connection pool metrics

   - Had alarms for query latency
   - No alarms for active connections count

3. **Inadequate code review:** Reviewer didn't spot missing release()

   - PR approved without running locally
   - No checklist for connection management

4. **Deployment process:** No gradual rollout
   - Deployed to 100% of production immediately
   - No canary deployment

## What Went Well

1. ✅ **Fast detection:** Alert fired within 3 minutes
2. ✅ **Clear runbook:** DBA runbook had exact steps to follow
3. ✅ **Quick decision:** Made rollback decision in 8 minutes
4. ✅ **Communication:** Status page updated every 5 minutes
5. ✅ **Rollback capability:** Automated rollback took <2 minutes

## What Went Wrong

1. ❌ **Code review missed bug:** Connection leak not caught
2. ❌ **Testing gaps:** Load tests insufficient duration
3. ❌ **No canary:** Deployed to all instances at once
4. ❌ **Late detection:** 17 minutes between deploy and alert

## Action Items

| Action                                        | Owner   | Due Date   | Priority | Status         |
| --------------------------------------------- | ------- | ---------- | -------- | -------------- |
| Add connection pool metrics to dashboards     | Jane    | 2024-01-20 | P0       | ✅ Done        |
| Create PR checklist for connection management | John    | 2024-01-22 | P0       | ✅ Done        |
| Extend load tests to 30 minutes minimum       | QA Team | 2024-01-25 | P1       | 🔄 In Progress |
| Implement canary deployment (10% → 100%)      | DevOps  | 2024-02-01 | P1       | 📋 Planned     |
| Add connection leak detection to tests        | Jane    | 2024-01-27 | P1       | 🔄 In Progress |
| Review all DB connection usage patterns       | John    | 2024-02-05 | P2       | 📋 Planned     |
| Improve alert routing (faster escalation)     | DevOps  | 2024-02-10 | P2       | 📋 Planned     |

## Lessons Learned

1. **Code review checklists work:** Need specific items for common issues
2. **Load tests need realistic duration:** 5min insufficient for leaks
3. **Gradual rollouts catch issues:** 10% canary would have limited impact
4. **Monitoring gaps are dangerous:** Add metrics before you need them
5. **Runbooks save time:** Clear procedures enabled fast response

## Related Incidents

- [2023-11-20] Database CPU spike (similar connection pool issue)
- [2023-08-15] Memory leak in cache layer

## Prevention

To prevent similar incidents:

1. ✅ Add connection management to code review checklist
2. ✅ Monitor connection pool utilization
3. ✅ Extend load test duration
4. ✅ Implement canary deployments
5. ✅ Add automated connection leak detection

## Appendix

### Monitoring Graphs

[Insert graphs of connection pool, error rates, latency during incident]

### Communication Log

[Insert status page updates and customer communication]

### Code Fix

PR #1235: Fix connection leak in user profile endpoint
\`\`\`typescript
const client = await pool.connect();
try {
const user = await client.query('SELECT \* FROM users WHERE id = $1', [id]);
return user;
} finally {
client.release(); // ✅ Always release
}
\`\`\`
```

## Postmortem Best Practices

```markdown
# Blameless Postmortem Guidelines

## Do ✅

- Focus on systems and processes, not people
- Use timeline with exact timestamps
- Identify contributing factors, not just root cause
- Create actionable items with owners and dates
- Document what went well (positive reinforcement)
- Share widely for organizational learning

## Don't ❌

- Blame individuals or teams
- Hide or minimize the incident
- Skip the postmortem (even for small incidents)
- Create action items without owners
- Forget to follow up on action items
- Make it a blame session

## Template Sections

1. **Summary** (2-3 sentences)
2. **Impact** (numbers: users, revenue, duration)
3. **Timeline** (chronological events)
4. **Root Cause** (technical explanation)
5. **Contributing Factors** (broader context)
6. **What Went Well** (positive reinforcement)
7. **What Went Wrong** (improvement areas)
8. **Action Items** (concrete, owned, dated)
9. **Lessons Learned** (key takeaways)
```

## Output Checklist

- [ ] Timeline created
- [ ] Root cause identified
- [ ] Contributing factors documented
- [ ] Action items with owners
- [ ] Lessons learned captured
- [ ] Postmortem meeting held
- [ ] Document shared widely
- [ ] Follow-up scheduled
      ENDFILE

© patricio0312rev · MIT · patricio0312rev/skills

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

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

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

Весь набор →
data-seeding-fixtures-builder Скилл data-seeding-fixtures-builder генерирует детерминированные тестовые данные, фабрики сущностей и скрипты сброса базы данных для разработки и тестов. CX Codex +1 265установок docs-starter-kit Скилл docs-starter-kit генерирует комплект проектной документации: файлы README, CONTRIBUTING, SECURITY, лицензию и правила поведения для открытых и закрытых репозиториев. CX Codex +1 265установок prompt-regression-tester Скилл prompt-regression-tester сравнивает старую и новую версии промпта на наборе тестов, находит регрессии и предлагает правки. CX Codex +1 265установок release-automation-builder Скилл release-automation-builder для Claude Code настраивает автоматические релизы и публикацию пакетов. Запускается по запросам о версиях, журнале изменений или выпуске пакета. CX Codex +1 265установок schema-consistency-checker Скилл schema-consistency-checker проверяет схему базы на единый стиль имён, типы id, NULL в критичных полях и внешние ключи без индекса, а потом отдаёт список нарушений с рекомендациями. CX Codex +1 265установок deployment-checklist-generator Скилл deployment-checklist-generator создаёт чек-листы деплоя, смоук-тесты, пайплайны GitHub Actions и планы верификации релиза для безопасного выкатывания в прод. CX Codex +1 264установок api-versioning-deprecation-planner Скилл api-versioning-deprecation-planner помогает выбрать стратегию версионирования API, составить план отказа от старой версии и подготовить руководство для перехода клиентов. CX Codex +1 264установок state-ux-flow-builder Скилл state-ux-flow-builder помогает собрать единые состояния загрузки, ошибки, пустого результата и успеха для экранов с данными. Пригодится при проектировании сложных UI-переходов. CX Codex +1 264установок

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

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