incident-runbook-templates

概要

incident-runbook-templatesとは？

incident-runbook-templatesは、エンジニアリングや運用チームが構造化された実践的なインシデント対応ランブックを作成できるGitHubスキルです。これらのテンプレートは、サービス障害や運用インシデント発生時の検知、トリアージ、緩和、解決、コミュニケーションの各ステップを案内します。重要システムを管理するチーム、新しいオンコールエンジニアの教育、複数プロジェクト間でのエスカレーション手順の標準化に最適です。

このスキルは誰が使うべき？

• サイト信頼性エンジニア（SRE）
• DevOpsチーム
• エンジニアリングマネージャー
• オンコール対応者
• 運用インシデント管理を担当するすべての方

どんな課題を解決する？

incident-runbook-templatesは、緊迫したインシデント時に明確な段階的ガイダンスが必要な課題に対応します。チームが以下を実現できるよう支援します：

• 復旧手順やエスカレーション経路の文書化
• 障害、データベース問題などサービス固有のランブック作成
• チーム間での対応手順の標準化
• 新規対応者のオンボーディングの負担軽減

使い方

インストール手順

1. 以下のコマンドでエージェントまたはプロジェクトにスキルを追加します：
   npx skills add https://github.com/wshobson/agents --skill incident-runbook-templates
2. 主なファイルを確認してください：
   • SKILL.md（主要なスキルドキュメント）
   • README.md、AGENTS.md、metadata.json（存在する場合）
   • rules/、resources/、references/、scripts/フォルダ内の補助資料も参照

テンプレートの適用方法

• まずSKILL.mdを読んで、重大度レベルやランブック構成を理解しましょう
• チームのツール、エスカレーションマトリクス、運用制約に合わせてテンプレートをカスタマイズしてください
• 重大度レベル表を使って、対応時間や影響範囲を環境に合わせて定義しましょう

どんな場合に適している？

• インシデント対応ドキュメントを作成または改善したい場合
• チームに共通のランブックがなく標準化したい場合
• 新しいエンジニアを明確で実践的なガイドで教育したい場合

どんな場合に適さない？

• 既に包括的で最新のランブックがある場合
• インシデント対応が完全に自動化されており手動手順が不要な場合

よくある質問

主なランブックテンプレートはどこにありますか？

Filesタブを開き、SKILL.mdをプレビューすると、コアテンプレートと重大度レベルのガイダンスが確認できます。

incident-runbook-templatesはどんな種類のインシデントにも使えますか？

はい。サービス障害、データベース障害、インフラ問題など様々なインシデントタイプに合わせてテンプレートを調整可能です。

エスカレーション経路や復旧手順はどうやってカスタマイズしますか？

SKILL.md内のテンプレートセクションを編集し、チームのエスカレーションマトリクス、連絡先、復旧手順を反映させてください。

どのファイルから始めるのが推奨ですか？

まずSKILL.mdを読み、重大度レベルやランブックの構成を把握し、その後必要に応じて補助ファイルを参照してください。