mcpField
A
agent-role-design

agent-role-design

github.com/owl-listenerエージェントワークフロー191132 回インストール20 週間前に更新
リポジトリ

agent-role-design について

agent-role-designは、マルチエージェントシステムの責任、知識範囲、権限、境界を定める設計スキルです。役割の仕様と競合時のルールを明確にし、作業の重複を抑えて連携を整理します。

主な機能

  1. 01目的・能力・知識範囲の定義
  2. 02権限と役割境界の明確化
  3. 03専門家・ルーター・オーケストレーターの役割パターン
  4. 04役割の競合とエスカレーション規則
  5. 05役割カードと連携マップ

活用シーン

  1. 01マルチエージェントシステムの役割設計
  2. 02エージェント間の担当範囲の整理
  3. 03意見が異なる場合のエスカレーション計画

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/owl-listener/ai-design-skills --skill agent-role-design

インストール後、Claude Code で/agent-role-designを入力して読み込まれたか確認します。

詳細

エージェントの役割設計

マルチエージェントシステムでは、各エージェントに、何を行うのか、何を知っているのか、何に責任を負うのか、どこまで権限を持つのかを明確に定義する必要があります。役割が明確でないと、エージェント同士で作業が重複したり、対立したり、対応の抜け漏れが生じたりします。

エージェントの役割を定義する

システム内の各エージェントについて、次の項目を指定します。

  • 目的:このエージェントは何のために存在しますか?存在理由を一文で説明します。
  • 能力:このエージェントには何ができますか?具体的なアクションと出力を挙げます。
  • 知識の範囲:このエージェントは何について知っていますか?どの領域、データ、コンテキストにアクセスできますか?
  • 権限:このエージェントはどのような判断を自律的に行えますか?何に承認が必要ですか?
  • 境界:このエージェントの範囲外であることは何ですか?どこで作業を止め、引き継ぎますか?
  • 成功基準:このエージェントが適切に役割を果たしていることを、どうすれば判断できますか?

役割設計の原則

  • 単一責任:各エージェントには明確な目的を一つ持たせます。何をするのか説明するのに段落が必要なら、担当範囲が広すぎます。
  • 明確な境界:あるエージェントの担当範囲と別のエージェントの担当範囲の境界を、曖昧さのないものにします。明示的な競合解決の仕組みがない限り、権限を重複させてはいけません。
  • 最小限の結合:エージェントは、他のエージェントへの依存を最小限に抑えて作業できるようにします。共有するのはプロセスではなく結果です。
  • 適切な自律性:自律的な意思決定の度合いを、リスクの大きさと、その領域におけるエージェントの信頼性に合わせます。

役割のパターン

  • スペシャリスト:一つの領域に深い専門知識を持ちます。特定の種類のタスクをすべて担当します。
  • ルーター:自ら作業は行わず、適切なスペシャリストにタスクを振り分けます。
  • オーケストレーター:ワークフロー全体を管理し、スペシャリスト間の連携を調整します。
  • バリデーター:品質、安全性、コンプライアンスの観点から、他のエージェントの出力をレビューします。
  • フォールバック:他のエージェントが対応できない、または対応しないケースを処理します。

役割の競合

エージェントの役割が重複したり競合したりする場合は、次の点を定めます。

  • 優先ルール:二つのエージェントが同じタスクに対応できる場合、どちらが担当しますか?
  • エスカレーション経路:エージェント間で意見が一致しない場合、誰が判断しますか?
  • 共有リソース:エージェントが同じデータやツールを必要とする場合、アクセスをどのように管理しますか?
  • フィードバックループ:エージェントは、実施した内容をどのように互いに伝えますか?

設計成果物

  • エージェントの役割カード(各エージェントにつき一枚。すべての仕様を記載)
  • 各エージェントの権限の開始点と終了点を示す役割境界マップ
  • エージェント間の通信関係を示すインタラクションマトリックス
  • 権限階層図
  • 役割の競合を解決するルール

コメント