incident-commander

インシデントコマンダー

インシデントの重大度を分類し、異種イベントソースからタイムラインを再構成して、根本原因分析とアクションアイテムを含む構造化されたインシデントレビューを作成します。PagerDuty、Google SRE、Atlassian のインシデント管理プラクティスを、重大度スコアリング、エスカレーションマトリクス、コミュニケーションテンプレート、RCA フレームワーク、SLA／エラーバジェットの追跡に体系化しています。

主な機能

• 重大度の分類 — 収益、ユーザー範囲、データ／セキュリティリスク、サービスの重要度、影響範囲を多角的にスコアリングし、確信度とエスカレーション経路を含めて SEV-1 から SEV-4 に分類します。
• タイムラインの再構成 — ログ、アラート、Slack、デプロイイベントから時系列のタイムラインを作成し、フェーズの検出とギャップ分析を行います。
• インシデントレビュー — 5 Whys、Fishbone、Timeline、または Bow Tie の RCA と、分類済みのアクションアイテム（担当者、優先度、期限）を含む PIR を作成します。
• ポストモーテムの品質 — 網羅性の不足を検出し、アクションアイテムの品質をスコアリングして、MTTD／MTTR のベンチマークを行います。
• コミュニケーションとエスカレーション — 重大度に応じた社内／経営陣／顧客向け／ステータスページ用テンプレートを提供します。時間ベースのトリガーを備えた、技術（L1-L4）およびビジネスのエスカレーションマトリクスも提供します。
• SLA／エラーバジェットの追跡 — SLI／SLO／SLA の階層、エラーバジェット、バーンレートアラート、違反への対応を追跡します。

使用する場面

• アクティブなインシデントへの対応 — 重大度を分類し、指揮体制を確立して、緩和策を実施し、コミュニケーションを行う場合。
• インシデントレビューの実施 — タイムラインを再構成し、RCA を行って、アクションアイテムを割り当てる場合。
• エスカレーションの管理 — 重大度と経過時間に応じて、技術面およびビジネス面のエスカレーション経路を適用する場合。
• 対応プレイブック、コミュニケーションテンプレート、または SLA／エラーバジェットポリシーの作成や監査を行う場合。

まず確認すること

成果物を作成する前に、以下の入力を確認してください。不明または曖昧な項目があれば、推測せずに質問してください。

• タスクと成果物 — 重大度の分類、タイムラインの再構成、または PIR／ポストモーテムの作成（severity_classifier.py、timeline_reconstructor.py、pir_generator.py／postmortem_generator.py のいずれを使うかを決定します）
• インシデントの入力データ — 重大度の評価項目（収益、ユーザー範囲、データ／セキュリティリスク、影響範囲）を含むインシデント／イベントの JSON（スクリプトが解析する入力です）
• RCA 手法 — 5 Whys、Fishbone、Timeline、または Bow Tie（pir_generator.py --rca-method とポストモーテムの構成を設定します）

停止ルール：出力に最も影響する 2～3 項目だけを質問してください。ユーザーが「とにかく草案を作って」と言った場合は作成を進め、成果物の冒頭に前提を記載してください。

ツール

ツール	目的	コマンド
incident_classifier.py	重大度を分類し、対応チームとコミュニケーションテンプレートを推奨します	python scripts/incident_classifier.py --input incident.json --format text
severity_classifier.py	多角的に重大度をスコアリングし、エスカレーション経路を示します	python scripts/severity_classifier.py incident.json --format markdown
timeline_reconstructor.py	タイムスタンプ付きイベントから、フェーズ検出とギャップ分析を行いながらタイムラインを再構成します	python scripts/timeline_reconstructor.py --input events.json --detect-phases --gap-analysis --format markdown
incident_timeline_builder.py	MTTD／MTTR とコミュニケーションテンプレートを含む構造化タイムラインを作成します	python scripts/incident_timeline_builder.py incident_data.json --format markdown
pir_generator.py	RCA とアクションアイテムを含むインシデント後レビューを作成します	python scripts/pir_generator.py --incident incident.json --rca-method fishbone --action-items
postmortem_generator.py	5 Whys、ベンチマーク、網羅性の不足を含むポストモーテムを作成します	python scripts/postmortem_generator.py incident_data.json --format markdown

参考資料

タスクに合った参考資料を読み込みます。このファイルは簡潔に保ち、必要に応じて詳細を確認してください。

• references/response-playbooks.md — クイックスタートコマンド、検知から解決までのワークフロー、インシデント後レビューのワークフロー、エスカレーション管理、アンチパターン、ツールのトラブルシューティングをまとめています。インシデントに最初から最後まで対応するときや、スクリプトを使うときに読んでください。
• references/incident-response-framework.md — PagerDuty／Google SRE／Atlassian のフレームワーク比較、役割の定義（IC、Comms、Ops、Scribe、SME、Liaison）、コミュニケーションプロトコル、エスカレーションマトリクス、インシデント対応の7段階のライフサイクルをまとめています。対応プロセスの設計や役割の割り当てを行うときに読んでください。
• references/incident_severity_matrix.md — SEV-1からSEV-4までの影響基準、対応要件、エスカレーション経路、分類ガイドライン、判断ツリー、具体例をまとめています。重大度の分類や調整を行うときに読んでください。
• references/communication_templates.md — 重大度別の社内向け、経営陣向け、顧客向け、ステータスページ向け、エスカレーション用、解決報告用のすぐに使えるテンプレートをまとめています。インシデントに関する連絡文を作成するときに読んでください。
• references/rca_frameworks_guide.md — 5 Whys、Fishbone、Timeline、Bow Tie の各フレームワークについて、テンプレート、選択ガイド、アンチパターンとともに、手順を追って解説しています。根本原因分析を行うときに読んでください。
• references/sla-management-guide.md — SLI／SLO／SLA の階層、エラーバジェットポリシー、バーンレートアラート、SLA違反への対応、インシデントとSLAの対応付けを、実例とともにまとめています。SLAへの影響を評価または伝達するときに読んでください。

対象範囲と制限事項

対象範囲: 重大度の分類、タイムラインの再構築、PIR／ポストモーテムの生成、RCAフレームワーク、エスカレーションマトリクス、コミュニケーションテンプレート、SLA／エラーバジェットの追跡を扱います。ツールは標準ライブラリのみを使う決定論的なPython実装で、JSONを入力として受け取り、テキスト／JSON／Markdownを出力します（ML／LLMの呼び出しはありません）。

対象外: ライブモニタリング／アラート基盤（senior-devops から情報を受け取ります）、セキュリティフォレンジック（senior-secops を参照）、デプロイ／ロールバックの実行（release-orchestrator を参照）。

連携ポイント

スキル	連携内容
senior-devops	モニタリングアラートをタイムラインに取り込み、ランブックテンプレートをプレイブックに反映します
senior-secops	セキュリティインシデントは自動的にSEV-1へエスカレーションされ、侵害の兆候がある場合はSecOps対応を開始します
release-orchestrator	デプロイイベントをタイムラインに取り込み、ロールバックデータをリリースゲートに反映します
senior-architect	アーキテクチャに起因する根本原因は、アーキテクチャレビューにエスカレーションします
code-reviewer	PIRのアクション項目をコードレビューのワークフローに振り分けます