agent-role-design について
agent-role-designは、マルチエージェントシステムの責任、知識範囲、権限、境界を定める設計スキルです。役割の仕様と競合時のルールを明確にし、作業の重複を抑えて連携を整理します。
主な機能
- 01目的・能力・知識範囲の定義
- 02権限と役割境界の明確化
- 03専門家・ルーター・オーケストレーターの役割パターン
- 04役割の競合とエスカレーション規則
- 05役割カードと連携マップ
活用シーン
- 01マルチエージェントシステムの役割設計
- 02エージェント間の担当範囲の整理
- 03意見が異なる場合のエスカレーション計画
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ owl-listener/ ai-design-skills --skill agent-role-designインストール後、Claude Code で/agent-role-designを入力して読み込まれたか確認します。
詳細
エージェントの役割設計
マルチエージェントシステムでは、各エージェントに、何を行うのか、何を知っているのか、何に責任を負うのか、どこまで権限を持つのかを明確に定義する必要があります。役割が明確でないと、エージェント同士で作業が重複したり、対立したり、対応の抜け漏れが生じたりします。
エージェントの役割を定義する
システム内の各エージェントについて、次の項目を指定します。
- 目的:このエージェントは何のために存在しますか?存在理由を一文で説明します。
- 能力:このエージェントには何ができますか?具体的なアクションと出力を挙げます。
- 知識の範囲:このエージェントは何について知っていますか?どの領域、データ、コンテキストにアクセスできますか?
- 権限:このエージェントはどのような判断を自律的に行えますか?何に承認が必要ですか?
- 境界:このエージェントの範囲外であることは何ですか?どこで作業を止め、引き継ぎますか?
- 成功基準:このエージェントが適切に役割を果たしていることを、どうすれば判断できますか?
役割設計の原則
- 単一責任:各エージェントには明確な目的を一つ持たせます。何をするのか説明するのに段落が必要なら、担当範囲が広すぎます。
- 明確な境界:あるエージェントの担当範囲と別のエージェントの担当範囲の境界を、曖昧さのないものにします。明示的な競合解決の仕組みがない限り、権限を重複させてはいけません。
- 最小限の結合:エージェントは、他のエージェントへの依存を最小限に抑えて作業できるようにします。共有するのはプロセスではなく結果です。
- 適切な自律性:自律的な意思決定の度合いを、リスクの大きさと、その領域におけるエージェントの信頼性に合わせます。
役割のパターン
- スペシャリスト:一つの領域に深い専門知識を持ちます。特定の種類のタスクをすべて担当します。
- ルーター:自ら作業は行わず、適切なスペシャリストにタスクを振り分けます。
- オーケストレーター:ワークフロー全体を管理し、スペシャリスト間の連携を調整します。
- バリデーター:品質、安全性、コンプライアンスの観点から、他のエージェントの出力をレビューします。
- フォールバック:他のエージェントが対応できない、または対応しないケースを処理します。
役割の競合
エージェントの役割が重複したり競合したりする場合は、次の点を定めます。
- 優先ルール:二つのエージェントが同じタスクに対応できる場合、どちらが担当しますか?
- エスカレーション経路:エージェント間で意見が一致しない場合、誰が判断しますか?
- 共有リソース:エージェントが同じデータやツールを必要とする場合、アクセスをどのように管理しますか?
- フィードバックループ:エージェントは、実施した内容をどのように互いに伝えますか?
設計成果物
- エージェントの役割カード(各エージェントにつき一枚。すべての仕様を記載)
- 各エージェントの権限の開始点と終了点を示す役割境界マップ
- エージェント間の通信関係を示すインタラクションマトリックス
- 権限階層図
- 役割の競合を解決するルール
コメント
Markdown 対応