agent-runtime-governance

エージェントランタイムガバナンス

ツールを使用するエージェントシステムを、予測可能で、可観測性があり、安全に運用できる状態に保つための制御を設計・監査します。

対象範囲： ツール、メモリ、承認、サブエージェント、評価、または外部システムを使用するエージェントのランタイムガバナンスです。一般的な脆弱性スキャン（security-scanner）、通常のコードレビュー（review）、プロンプトのみの最適化（prompt-engineer）、MCP の実装詳細（mcp-creator）は対象外です。

ディスパッチ

$ARGUMENTS	モード	アクション
空	menu	ガバナンスモードと必要な入力を表示します
design <system>	design	新規または変更中のエージェントシステムのランタイムポリシーを定義します
audit <path-or-system>	audit	既存のツール、承認、メモリ、テレメトリ、評価の制御をレビューします
permissions <agent-or-tools>	permissions	許可リスト、拒否リスト、承認モード、エスカレーションルールを設計します
memory <agent-or-system>	memory	メモリの範囲、保持期間、プライバシー、無効化ポリシーを定義します
evals <workflow>	evals	回帰、敵対的テスト、ランタイム受け入れ評価のループを計画します
rollout <system>	rollout	段階的リリース、監視、ロールバック、運用担当者の準備状況に関する制御を定義します
incident <failure-mode>	incident	エージェントの障害に対する封じ込めと復旧の制御を定義します
エージェントのツール、権限、メモリ、評価、封じ込めに関する自然言語での依頼	自動判定	最も近いモードを自動判定します

ガバナンス対象領域

対象領域	確認事項
ツール	どのツールが読み取り、書き込み、支出、デプロイ、ユーザーへのメッセージ送信、データ削除を行えますか？
承認	どの操作に明示的なユーザー承認または人によるレビューが必要ですか？
メモリ	何を、どの期間、どの範囲で保存できますか？
状態	何が永続的で、再生可能で、冪等で、監査可能ですか？
テレメトリ	どのトレース、判断、ツール呼び出し、障害を観測できますか？
評価	リリース前の回帰を防ぐシナリオは何ですか？
封じ込め	システムはどのように停止、ロールバック、隔離、または安全な縮退を行いますか？

正式な用語

ガバナンスレポートを作成する際は、以下の正式な用語をそのまま使用してください。

用語	意味
ツールの影響	ツール呼び出しが現実世界にもたらす影響です。読み取り、書き込み、デプロイ、メッセージ送信、支出、削除、公開が含まれます
承認ゲート	リスクの高い操作の前に設ける、明示的な人またはポリシーによるチェックポイントです
ランタイムガード	ガバナンスルールを適用するフック、ラッパー、許可リスト、拒否リスト、テスト、またはプラットフォームポリシーです
メモリ境界	保存されたエージェントコンテキストに対する範囲、保持期間、編集、無効化のポリシーです
封じ込め	安全でない動作や障害の後に行う停止、ロールバック、隔離、または縮退の措置です
シャドーモード	提案された操作を記録する一方で、実行しないランタイムモードです

分類ゲート

モードを選ぶ前に、依頼を分類します。

1. アプリの脆弱性スキャンを求めている場合は、security-scanner に振り分けます。
2. コードレビューを求めている場合は、review に振り分けます。
3. プロンプトの文言のみを求めている場合は、prompt-engineer に振り分けます。
4. MCP サーバーの実装方法を求めている場合は、mcp-creator に振り分けます。
5. それ以外の場合は、ディスパッチ表から最も適切なランタイムガバナンスモードを選びます。

ワークフロー

1. エージェントの役割、ユーザー、データの機密性、外部への影響を定義します。
2. ツールを機能別に一覧化します。読み取り専用、書き込み、破壊的操作、金銭、デプロイ、メッセージ送信、認証情報へのアクセス、ネットワークへの送信に分類します。
3. 影響、可逆性、信頼度に応じて承認ゲートを対応付けます。
4. メモリの範囲、保持期間、編集、無効化のルールを定義します。
5. ツール呼び出し、判断、承認結果、障害についてテレメトリを必須とします。
6. 安全でないツール使用、古いメモリ、承認漏れ、障害の封じ込めを中心に評価を構築します。
7. ライブユーザー、アカウント、認証情報、外部システムに影響する変更について、リリースゲート、ロールバック基準、運用担当者が確認できる証跡を定義します。
8. 担当者と適用箇所を含むガバナンスマトリクスを提示します。

スケーリング戦略

スコープ	戦略
単一のエージェントまたはワークフロー	制御マトリックスと評価・監視セットをそれぞれ1つ作成します
ツールを共有する複数のエージェント	ツールの影響度と共通の承認ゲートに基づいてグループ化します
プラットフォーム全体のガバナンス	まず基本ポリシーを定義し、その後、エージェントのクラスごとに例外を設けます
本番環境へのライブ展開	段階的な展開、ロールバック、監視、担当者によるレビューの各ゲートを追加します

段階的な開示

• ルーティングと制御対象を把握するには、この SKILL.md から始めてください。
• 権限、メモリー、テレメトリー、評価の制御については、references/control-matrix.md をお読みください。
• リリース、ロールバック、監視、本番環境への準備が対象となる場合にのみ、references/rollout-governance.md をお読みください。
• ルーティングによってそれらのスキルに誘導されない限り、セキュリティ、プロンプト、MCP の実装に関するリファレンスは読み込まないでください。

リファレンスファイル一覧

ファイル	読むタイミング
references/control-matrix.md	ランタイムの制御対象を設計または監査するとき
references/rollout-governance.md	段階的なリリース、ロールバック、監視、オペレーターの準備を計画するとき

出力形式

## Agent Governance Report

- System:
- Mode:
- Risk tier:

### Control Matrix
| Surface | Current | Required | Enforcement | Evidence |
|---|---|---|---|---|

### Required Changes
- ...

### Evals And Monitoring
- ...

### Rollout And Containment
- ...

重要なルール

1. 自律性を推奨する前に、ツールを影響度に基づいて分類します。
2. 取り消せない操作、コストのかかる操作、公開操作、認証情報に関わる操作、または破壊的な操作には、明示的な承認を必須とします。
3. メモリーの範囲を限定し、保持、編集、無効化について記録します。
4. ツール呼び出し、承認、拒否、失敗、封じ込め措置について、テレメトリーを必須とします。
5. 安全でないツールの使用、承認の欠落、古いメモリー、ロールバックの動作を対象とした評価を追加します。
6. ポリシーと適用を分離し、各ルールを適用するフック、ラッパー、テスト、またはランタイムゲートを明示します。
7. security-scanner、review、prompt-engineer、mcp-creator の役割を置き換えないでください。依頼がランタイムガバナンスの範囲外である場合は、該当するものに誘導してください。
8. 展開、ロールバック、監視の基準がなければ、ガバナンス変更を準備完了としないでください。

検証要件

変更完了を宣言する前に、このスキルのディレクトリから実行してください。

python scripts/check.py

完了基準：

1. scripts/check.py が 0 で終了すること。
2. このスキルのディレクトリ内に、ポータブル CLI に関する違反が残っていないこと。
3. スモークレビューで、明示的、暗黙的、展開関連、ネガティブコントロールの各プロンプトを網羅すること。