claude-advisory-protocol は何をしますか？
AIコーディングエージェント向けの判断ゲート：重大な結果を伴う選択の前に、より強力なモデルにエスカレーションします。5つのトリガー、4層のラダー、構造化されたアドバイザーブリーフを提供します。
概要
このプロトコルは、AIエージェント（Claude Code、Cursor、Codexなど）が自律的に行動する際に、高リスクな判断を人間のレビュアーやより強力なモデルにエスカレーションするためのフレームワークを定義します。
トリガー
以下の条件が満たされた場合、プロトコルが起動します：
- セキュリティ関連：APIキー、認証情報、または機密データへのアクセスや変更が検出された場合。
- データ損失：大量のデータ削除、データベースの変更、または破壊的な操作が試みられた場合。
- 外部サービス：本番環境の外部サービス（AWS、Azure、GitHubなど）への変更が含まれる場合。
- コスト関連：予想を超えるコスト（例：クラウドリソースの増加、API呼び出しの多さ）が発生する可能性がある場合。
- 依存関係：クリティカルな依存関係の変更（例：ライブラリのメジャーバージョンアップグレード）が含まれる場合。
エスカレーションラダー
エスカレーションは4段階で行われます：
| レベル | 説明 | アクション |
|---|---|---|
| 0 | 自己解決 | エージェントが自身で問題を解決する（例：明確化の質問）。 |
| 1 | モデル内エスカレーション | より強力なモデル（例：Claude Opus）にリクエストを転送する。 |
| 2 | 人間のレビュアー | 人間の開発者または管理者に通知し、承認を求める。 |
| 3 | 上級管理者 | 緊急時、上級管理者にエスカレーションし、アクションを一時停止する。 |
アドバイザーブリーフ
各エスカレーション時に、以下の構造化されたブリーフが生成されます：
- コンテキスト：現在の状況の説明（適用されるトリガーを含む）。
- 選択肢：考えられるアクションのリスト（各選択肢の評価付き）。
- 推奨：エージェントが推奨するアクション。
- リスク評価：各選択肢のリスク（高/中/低）。
使用方法
エージェントにこのプロトコルを統合するには、以下の環境変数または設定が必要です：
# エスカレーションレベル（0-3）
export ADVISORY_ESCALATION_LEVEL=1
# 通知先（人間のレビュアー用）
export [email protected]
コード内でプロトコルを呼び出す例：
from advisory_protocol import escalate
trigger = detect_triggers(current_action)
if trigger:
brief = generate_brief(trigger, context)
result = escalate(level=1, brief=brief)
print(f"エスカレーション結果: {result}")
対応プラットフォーム
- Claude Code
- Cursor
- Codex (OpenAI)
- その他、カスタムエージェント
ライセンス
MIT