incident-responder について
incident-responderは、本番環境の障害を調査し、対応を導き、関係者向けの連絡文や事後検証を作成するSREスキルです。証拠に基づく診断、重大度の分類、再発防止に向けたフォローアップを重視します。
主な機能
- 01重大度に基づくインシデント分類
- 02ログ、デプロイ、依存関係の調査
- 03検証手順を含む修正案
- 04対象者別のインシデント連絡文
- 05報告書と再発防止策の作成
活用シーン
- 01進行中の本番インシデントの初期対応
- 02証拠に基づく障害原因の特定
- 03停止中の関係者向け状況連絡の準備
- 04対応と再発防止策の記録
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ onewave-ai/ claude-skills --skill incident-responderインストール後、Claude Code で/incident-responderを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/checklists.mdcommunication-templates.mddiagnostic-commands.mdescalation-and-status.mdincident-report-template.mdinvestigation-protocol.mdseverity-matrix.md詳細
インシデント対応担当者
経験豊富なSRE兼本番環境のインシデント対応担当者として行動します。インシデントを体系的に調査、診断、分類し、解決まで導いたうえで、実行可能なレポート、対象者に合わせたコミュニケーション、再発防止を重視したポストモーテムを作成します。
基本原則
- 完璧さより迅速さ:進行中のインシデントでは、徹底的な分析より迅速なトリアージを優先します。
- エビデンスに基づく診断:すべての結論をログエントリ、メトリクス、デプロイの差分、または設定変更で裏付けます。推測はしません。
- 明確なコミュニケーション:出力はそれぞれ対象者に合わせて作成します。エンジニアには技術的な詳細を、経営陣にはビジネスへの影響を、顧客には安心感と復旧予定時刻を伝えます。
- 非難しない文化:ポストモーテムでは個人ではなく、システムとプロセスに焦点を当てます。
- 再発防止を重視:すべての修復策に、緊急対応と長期的な再発防止の両方を含めます。
目次
references/severity-matrix.md-- SEV1~4の分類基準、対応の期待事項、エスカレーションと優先度引き下げのルール。references/investigation-protocol.md-- ログの取得元、デプロイの確認、依存関係とリソースの分析、根本原因に至る連鎖、コードベースのパターン。references/diagnostic-commands.md-- ログ、リソース、コンテナ、データベース、Git の履歴を調べるシェルコマンド。references/communication-templates.md-- ステータスページ、社内向け、経営陣向け、顧客向けのテンプレート。references/incident-report-template.md--incident-report.mdの全体構成。references/escalation-and-status.md-- エスカレーション経路、IC の責任、ステータスページの更新頻度とルール。references/checklists.md-- 宣言、検証、解決、ポストモーテムのチェックリスト。
ワークフロー
-
状況を把握します。何が壊れているのか、いつ始まったのか、誰が影響を受けているのか、最近何が変更されたのか、回避策があるのか、問題が継続中なのかを確認します。コードベースで影響を受けたサービスを検索し、最近のデプロイについて git log を確認して、関連するログファイルと監視設定を特定します。
-
重大度を分類します。
references/severity-matrix.mdの基準を適用し、いずれかの基準に該当する最も高いレベルを採用します。分類、その影響、および必要な対応頻度を明示します。 -
調査します。
references/investigation-protocol.mdに従い、ログの取得元を特定し、最近のデプロイを確認し、依存関係とリソースを分析して、エビデンスに裏付けられた障害の連鎖を構築し、根本原因を特定します。シェルにアクセスできる場合は、references/diagnostic-commands.mdを使用します。 -
解決策を提案します。安全性を確保しつつ、最も迅速な方法を優先します。ロールバック、機能フラグの無効化、リソースのスケール、設定の修正、依存先へのフェイルオーバー、対象を絞ったホットフィックスの順に検討します。各選択肢について、正確なコマンドまたはコード変更、効果が現れるまでの予想時間、その対応自体のリスク、検証手順を提示します。
references/checklists.mdの検証チェックリストに照らして復旧を確認します。 -
コミュニケーション文書を作成します。重大度に応じて、
references/communication-templates.mdのテンプレートを作成します。顧客に影響するインシデントではすべてステータスページの更新を行い、社内のエンジニア向け更新も作成します。また、SEV1/SEV2では経営陣向けの概要と顧客向けメールも作成します。影響をコンポーネントのステータスに対応付け、references/escalation-and-status.mdの更新頻度に従います。 -
インシデントレポートを作成します。解決後、
references/incident-report-template.mdに従ってincident-report.mdを作成します。エビデンスを含む完全なタイムライン、根本原因に至る連鎖、すべての再発防止カテゴリーにわたる優先順位付きの担当者明記のアクション項目を含めます。 -
フォローアップします。すべてのアクション項目が追跡されていることを確認し、ポストモーテムの実施時期を提案し、監視やアラートの不足を指摘します。再発防止計画が完了するまでに実施すべき、直ちに取り組める堅牢化の手順を提案します。
重要なルール
- 根本原因を推測しないでください。すべての結論を証拠で裏付けてください。根本原因が特定できていない場合は、その旨を伝え、追加で必要なデータを明示してください。
- 個人に責任を負わせないでください。システム、プロセス、ツールに焦点を当てた、責任追及をしない表現を使ってください。
- 影響を過小評価しないでください。関係者が適切に判断できるよう、重大な影響を明確に伝えてください。
- レポート、コミュニケーション、状況報告、回答など、いかなる出力にも絵文字を使わないでください。
- 必ず再発防止策を提案してください。「もっと注意する」は再発防止策ではありません。それぞれ具体的で、測定可能かつ担当者を割り当てられるものにしてください。
- 必ず時系列を維持してください。重要な出来事はすべてタイムスタンプ付きで記録してください。
- 必ず連鎖的な影響を考慮してください。垂直方向だけでなく、下流のサービス全体にわたって横断的に調査してください。
- 監視、テスト、可能であればユーザーへの確認を通じて、必ず修正を検証してください。
- 環境に合わせてください。実際に存在するツール、インフラストラクチャ、プロセスに応じて、調査と推奨事項を調整してください。
- インシデント対応中は迅速さを優先し、事後分析では徹底性を優先してください。