Przejdź do treści
Biblioteka skilli
DevOps i chmura · Pisanie

postmortem

/postmortem

Pisze bezwinny postmortem po incydencie produkcyjnym, z analizą pięciu pytań „dlaczego” i działaniami zapobiegawczymi, by problem się nie powtórzył.

Repozytorium
claude-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
19.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 19.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co robi i kiedy

Pisze bezwinny postmortem po incydencie produkcyjnym, z analizą pięciu pytań „dlaczego” i działaniami zapobiegawczymi, by problem się nie powtórzył.

Wyzwalacze z opisu

postmortempost-incident reviewPIRwhat happened in that incidentincident reviewblameless postmortem5 whyshow do we prevent this again
Oryginalny opis (EN)

Write a blameless postmortem after an incident. Use when the user says "postmortem", "post-incident review", "PIR", "what happened in that incident", "incident review", "blameless postmortem", "5 whys", "how do we prevent this again", or needs to document learnings from a production incident - even if they don't explicitly say "postmortem".

Jak działa

  1. Overview
  2. Workflow
  3. Anti-Patterns
  4. Quality Checklist
Sekcje z nagłówków SKILL.md, w oryginale · 138 linii, 848 słów
Podgląd SKILL.md
---
name: postmortem
description: >
  Write a blameless postmortem after an incident. Use when the user says "postmortem",
  "post-incident review", "PIR", "what happened in that incident", "incident review",
  "blameless postmortem", "5 whys", "how do we prevent this again",
  or needs to document learnings from a production incident
  - even if they don't explicitly say "postmortem".
---

## Overview

Based on **"The Field Guide to Understanding Human Error"** by Sidney Dekker and the **Google SRE Book**. Dekker's fundamental insight: human error is never the cause of an incident - it is a symptom of a system that put people in a position where mistakes were likely. A blameless postmortem asks not "who made the mistake?" but "what conditions made this mistake likely, and how do we change those conditions?"

Google SRE's postmortem culture: incidents are opportunities to improve systems, not to assign blame. Engineers who feel safe reporting mistakes surface problems before they become incidents.

## Workflow

### Step 1: Schedule within 48 hours (SEV1) or 1 week (SEV2)

Postmortems decay in value quickly. Memories fade, context is lost. Set the meeting within 48 hours of a SEV1 resolution.

Attendees: IC, Operations Lead, on-call engineer(s), and anyone who can contribute to understanding what happened. No executives in the room - their presence changes behavior.

### Step 2: Build the timeline

Reconstruct what happened in chronological order. Be precise about times.

```
Timeline:
[HH:MM] - [what happened - system event, human action, or observation]
[HH:MM] - [alert fired: name]
[HH:MM] - [on-call engineer paged]
[HH:MM] - [first action taken]
[HH:MM] - [mitigation applied]
[HH:MM] - [service restored]
```

Include: system events, alerts, human decisions, and the reasoning people had at the time.

### Step 3: Identify contributing factors (not root cause)

Dekker's principle: complex systems rarely have a single root cause. They have contributing factors that aligned to create conditions for failure.

For each contributing factor, ask: "If this had been different, would the incident have been less likely or less severe?"

Common contributing factor categories:
- Technical: insufficient alerting, missing circuit breakers, inadequate testing
- Process: no deployment checklist, unclear escalation path, missing runbook
- Knowledge: alert with no runbook, undocumented dependency, new team member
- Capacity: system at limits, team understaffed, alert fatigue

### Step 4: Apply the 5 Whys

For the primary contributing factor, drill down:
- Why did X happen? - Because Y
- Why did Y happen? - Because Z
- Why did Z happen? - Because...

Stop when you reach a level where an action item can change the system. "Because the engineer made a mistake" is never the stopping point - that's where the analysis begins.

### Step 5: Write action items

Every postmortem must produce action items. Without them, it's just storytelling.

Each action item:

```
Action: [specific thing to do]
Owner: [named person, not "the team"]
Due: [specific date]
Priority: [P1 - fix before next deploy / P2 - this sprint / P3 - this quarter]
Type: [Prevention / Detection / Mitigation / Process]
```

Action types:
- **Prevention** - stops this failure mode from occurring
- **Detection** - makes the problem visible sooner
- **Mitigation** - reduces impact when it does occur
- **Process** - changes how the team responds

### Step 6: Write the postmortem document

```
Postmortem: [Incident title]
Date: [incident date]
Authors: [IC + contributors]
Severity: [SEV1/SEV2]
Duration: [start to resolution]
Impact: [users affected, features degraded]

Summary
[2-3 sentences: what happened, why it mattered, how it was resolved]

Timeline
[full timeline from Step 2]

Contributing Factors
[bullet list from Step 3 - no blame language]

5 Whys Analysis
[drill-down from Step 4]

What Went Well
[what helped contain or resolve the incident faster]

Action Items
[table from Step 5]

Lessons Learned
[2-3 insights that are generalizably useful beyond this specific incident]
```

### Step 7: Share broadly

Postmortems are most valuable when shared. Publish to an internal wiki, engineering all-hands, or team newsletter. Other teams often have the same latent failure modes.

## Anti-Patterns

**1. Blame language**
Bad: "The engineer deployed without testing."
Good: "The deployment process did not have a required staging environment check, making it possible to deploy untested code."
Dekker: blame stops investigation. "Human error" as a cause explains nothing and changes nothing.

**2. No action items**
Bad: Postmortem documents what happened but ends without concrete next steps.
Good: Every postmortem produces at least 2 action items with owners and dates. Track them to completion.

**3. Postmortem after the deadline**
Bad: "We'll get to it when things calm down." (more than 1 week for SEV1)
Good: Timebox it. A 60-minute postmortem within 48 hours is worth more than a 2-hour postmortem 3 weeks later.

**4. Only focusing on what went wrong**
Bad: Pure failure analysis, nothing about what was done right.
Good: Include "What went well." The practices that helped contain the incident should be reinforced, not just the failures fixed.

## Quality Checklist

- [ ] Scheduled within 48h (SEV1) or 1 week (SEV2)
- [ ] Timeline is precise (specific times, not "around noon")
- [ ] Contributing factors identified with no blame language
- [ ] 5 Whys drilled to a system-level cause, not a person
- [ ] Every action item has: owner (named), due date, priority, type
- [ ] "What went well" section included
- [ ] Document shared with broader engineering team
- [ ] Action items tracked to completion in next retrospective

Wersje

RepozytoriumWynikLicencja
Ta strona · qa-aman/claude-skills100MIT
duronext/jig100MIT
boshu2/agentops100Apache-2.0
fabioc-aloha/Alex_Skill_Mall100MIT
omexit/claude-skills-pack100MIT
biliboss/skills90MIT
alecs5am/ralphy87Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki 9ae969df290f (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100incident-postmortem
    Opracowuje analizę przyczyn źródłowych po rozwiązanym incydencie produkcyjnym: oś czasu, przyczyna metodą 5 whys i lista działań z właścicielami, bez szukania winnych.
  • 90incident-postmortem
    Pisze postmortem bez szukania winnych albo raport z incydentu na podstawie logów, alertów i wątków rozmów.
  • 100incident-review-guide
    Pomaga napisać bezwinny raport po incydencie według praktyk SRE: oś czasu, analiza przyczyn metodą 5 Whys, zadania i wnioski.
  • 100incident-postmortem
    Pisze postmortem bez szukania winnych po rozwiązaniu incydentu produkcyjnego: oś czasu, przyczyna metodą 5 whys i śledzone działania naprawcze.
  • 100incident-postmortem-blameless-rca-authoring
    Prowadzi i zapisuje postmortemy bez winnych, ustalając oś czasu i konkretne poprawki po incydencie.
  • 100ops-postmortem
    Pisze postmortem bez szukania winnych po incydencie SEV1 lub SEV2: oś czasu, czynniki wpływające i zadania z właścicielem i terminem.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.