postmortem について
postmortemは、チームが個人を責めずにインシデントを分析するための構造化スキルです。影響や経過、原因、教訓、担当者付きの対応事項を整理します。
主な機能
- 01非難しないインシデント分析
- 02概要とタイムラインの作成
- 03影響と根本原因の確認
- 04担当者付きアクション項目
- 05教訓の整理
活用シーン
- 01サービスインシデントの記録
- 02検知や緩和の遅れの振り返り
- 03再発防止作業の割り当て
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ neurofoo/ agent-skills --skill postmortemインストール後、Claude Code で/postmortemを入力して読み込まれたか確認します。
詳細
非難のないポストモーテム
インシデントを徹底的に分析し、何が起きたのかを理解して再発を防ぎます。
手順
各セクションに沿って、体系的に進めてください。個人ではなく、システムやプロセスに焦点を当てます。目的は非難ではなく、学習です。
出力形式
エグゼクティブサマリー
インシデント: [1行での説明] 日時: [発生日時] 継続時間: [継続した時間] 重大度: [Critical/High/Medium/Low]
概要 [何が起きたのか、影響、解決方法を2~3文で説明]
タイムライン
時刻はすべて[タイムゾーン]です。
| 時刻 | イベント | 実行者 |
|---|---|---|
| HH:MM | [何が起きたか] | [誰が/何が実行したか] |
| HH:MM | [検知] | [どのように気づいたか] |
| HH:MM | [対応アクション] | [誰が対応したか] |
| HH:MM | [解決] | [何によって解決したか] |
重要な局面
- トリガー: [インシデントの発端]
- 検知: [問題が起きていると、いつ、どのように把握したか]
- 緩和: [被害の拡大が止まった時点]
- 解決: [完全に解決した時点]
影響
顧客への影響
- 影響を受けたユーザー数: [人数]
- 影響が続いた時間: [時間]
- 発生した症状: [ユーザーから見えた事象]
ビジネスへの影響
- 収益への影響: [該当する場合]
- SLA/SLO 違反: [はい/いいえ、詳細]
根本原因分析
根本原因 [発生した根本的な理由。トリガーそのものではなく、なぜトリガーがインシデントにつながったのか]
トリガー [直接の原因。事態のきっかけとなったもの]
寄与した要因
| 要因 | どのように影響したか |
|---|---|
| [要因] | [説明] |
なぜ検知できなかったのか?
- なぜテストで検出できなかったのか?
- なぜ監視でより早くアラートが発報されなかったのか?
うまくいったこと
| うまくいったこと | 役立った理由 |
|---|---|
| [項目] | [説明] |
うまくいかなかったこと
| 失敗したこと | 影響 |
|---|---|
| [項目] | [影響] |
アクション項目
緊急(今週中)
| アクション | 担当者 | 期限 |
|---|---|---|
| [アクション] | [担当者] | [日付] |
短期(今月中)
| アクション | 担当者 | 期限 |
|---|---|---|
| [アクション] | [担当者] | [日付] |
学んだこと
- [教訓]
- [教訓]
- [教訓]
ガイドライン
- 非難しない: 「デプロイスクリプトで検証されなかった」とし、「Aliceが確認せずにデプロイした」としない
- 詳細なタイムライン: 恥ずかしい遅延も含め、すべてを記載する
- 具体的なアクション: 「メモリアラートを追加する」とし、「監視を改善する」としない
- 担当者を割り当てる: 担当者のいないアクションは実行されません
$ARGUMENTS
コメント
Markdown 対応