review-agent-setup は何をしますか?
Claude CodeでAIエージェントのレビューアクションに人間参加型ゲーティングを設定します。エージェントがPRレビュー、コメント、マージ、CI設定の編集を行うプロジェクトで、Cedarで強制されたゲートと暗号的監査可能な承認トレイルを実現したい場合に使用します。
概要
このスキルは、Claude Code上で動作するAIエージェントに対して、プルリクエスト(PR)レビュー、コメント、マージ、CI設定の編集などの重要なアクションに人間参加型の承認プロセスを導入します。
主な機能
- Cedarポリシーによるアクセス制御: Cedar言語で定義されたポリシーに基づいて、エージェントのアクションを許可または拒否します。
- 暗号監査トレイル: すべての承認アクションは暗号的に署名され、監査可能なログとして保存されます。
- 人間参加型ゲート: 重要な操作(例:PRマージ、CI設定の編集)には必ず人間の承認が必要となります。
- 柔軟なポリシー定義: プロジェクトのニーズに合わせてポリシーをカスタマイズできます。
設定方法
- このスキルをClaude Codeにインストールします。
- プロジェクトのルートに
review-agent-setup.ymlまたはreview-agent-setup.jsonファイルを作成します。 - 以下の例を参考にポリシーを定義します。
policies:
- action: "review"
require_approval: true
approvers: ["@team-leads"]
- action: "merge"
require_approval: true
approvers: ["@senior-devs"]
- action: "ci-edit"
require_approval: true
approvers: ["@devops"]
使用例
エージェントがPRレビューを投稿しようとすると、設定されたポリシーに基づいて承認が必要かどうかがチェックされます。承認が必要な場合、エージェントは人間の承認を待つ一時停止状態になります。
# エージェントがPRレビューを投稿しようとする例
claude code --skill wshobson/review-agent-setup --action review --pr 42
注意事項
- このスキルはClaude Codeプラグインとして動作します。
- ポリシーはプロジェクトごとに定義し、バージョン管理することを推奨します。
- 暗号署名にはプロジェクトのGPG鍵または同様のメカニズムを使用します。
詳細情報