SRE ランブックエージェントスキル
プロダクション SRE ランブックを作成、レビュー、安全に実⾏するためのポータブルエージェントスキル。
ランブックを作成し、クリーンなコンテキストでレビューし、⼀⼿順ずつ安全に実⾏します。
このリポジトリは、運⽤ドキュメントとインシデント対応ワークフローのための再利⽤可能なエージェントスキルを公開しています。これらのスキルは、SRE、プラットフォームエンジニア、DevOps エンジニア、インシデントコマンダー、オンコールエンジニアが、明確で安全かつ実⾏可能な AI アシストランブックを実現できるように設計されています。
これらのスキルのプラクティスは、Google SRE の実践と共通の SRE ベストプラクティス（実⾏可能なアラート、緊急対応、安全な復旧、検証、ロールバック基準、エスカレーション、明確な所有者）に触発されています。
含まれるスキル
| スキル | ⽬的 |
|---|---|
sre-runbook-author | アラート、インシデント、復旧、ロールバック、診断、エスカレーションのための実⾏重視のランブックを作成します。 |
sre-runbook-reviewer | クリーンなコンテキストの視点からランブックをレビューし、ギャップ、安全でない操作、暗黙の前提、検証の⾜りない部分を特定します。 |
sre-runbook-executor | 既存のランブックを⼀⼿順ずつ、証拠を保存し、曖昧な点で停⽌し、危険な操作には承認ゲートを設けて実⾏します。 |
使⽤例
- 「この⾼ 5xx アラートのランブックを作成して。」
- 「事前知識がない前提でこのランブックをレビューして。」
- 「このランブックを安全に実⾏し、危険な操作の前で停⽌して。」
- 「このロールバック⼿順における暗黙の前提や抜けているステップを⾒つけて。」
- 「このインシデント対応プロセスを、エージェントが実⾏可能な明確なランブックに変換して。」
インストール
互換性のあるツールは通常、SKILL.md を含むディレクトリをスキルとして認識します。
プロジェクトローカルインストール:
mkdir -p .agents/skills
cp -r skills/sre-runbook-* .agents/skills/
ユーザーレベルインストール:
mkdir -p ~/.agents/skills
cp -r skills/sre-runbook-* ~/.agents/skills/
⼀部のツールは、.gemini/skills/、~/.gemini/skills/、または製品固有の拡張デ��レクトリなど、⾃分たちのスキルまたはプラグインパスを使⽤します。インストールする前に、お使いのツールの最新ドキュメントを確認してください。
安全モデル
これらのスキルは、保守的なインシデント対応に基づいて構築されています:
- インシデント⼊⼒と該当するランブックから開始します。
- 読み取り専⽤の診断を、低リスクおよび⾼リスクの操作から分離します。
- ステップが曖昧な場合、必要なアクセスがない場合、または観測された状態がランブックと異なる場合に停⽌します。
- デプロイ、ロールバック、再起動、スケーリング操作、フェイルオーバー、設定変更、データ変更、権限変更、アラート抑制、リソース削除などの危険な操作の前に、明⽰的な承認を求めます。
- 証拠を保存し、実際の結果と期待される結果を⽐較します。
プロンプト例
アラート <ALERT_NAME> のプロダクション SRE ランブックを作成してください。ダッシュボード、しきい値、所有者、コマンドが不明な場合はプレースホルダーを使ってください。
このランブックをクリーンなコンテキストの視点からレビューしてください。午前3時にオンコールエンジニアを混乱させる可能性のあるものをすべて指摘してください。
このランブックを⼀⼿順ずつ実⾏してください。読み取り専⽤の診断から始め、危険な操作の前で停⽌してください。
例
ライセンス
このプロジェクトは MIT ライセンスの下でライセンスされています。 LICENSE を参照してください。