mcpField
H
handoff-protocols

handoff-protocols

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

handoff-protocols について

handoff-protocolsは、エージェント間およびエージェントと人間の間の引き継ぎを設計するスキルです。引き継ぎの流れ、コンテキスト転送、ユーザー体験、失敗パターン、設計成果物を扱います。

主な機能

  1. 01引き継ぎの契機、送信元、宛先、確認
  2. 02逐次、並列、エスカレーション、フォールバック
  3. 03コンテキスト転送の方式
  4. 04ユーザー向け引き継ぎ体験のパターン
  5. 05失敗パターンと設計成果物

活用シーン

  1. 01エージェント間でタスクを渡す条件と手順の定義
  2. 02引き継ぎ時のコンテキスト情報の設計
  3. 03ユーザーに見える引き継ぎやエスカレーションの計画
  4. 04コンテキストの欠落や作業停滞の点検

インストール

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

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

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

詳細

ハンドオフプロトコル

ハンドオフとは、あるエージェントが別のエージェント、または人間に作業を引き継ぐ瞬間です。マルチエージェントシステムで最もよく失敗が起きる場面です。ハンドオフが失われると、コンテキストの喪失、作業の重複、タスクの放棄につながります。

ハンドオフの構成要素

すべてのハンドオフには、次の要素があります。

  • トリガー:何がハンドオフを引き起こしますか?(タスクの完了、スコープの境界、失敗、ユーザーからの依頼)
  • 送信元:誰が引き継ぎますか?
  • 送信先:誰が引き継ぎますか?
  • ペイロード:どのような情報が引き継がれますか?(コンテキスト、途中までの結果、ユーザーの状態、指示)
  • 確認応答:送信元は、送信先がハンドオフを受け取ったことをどのように確認しますか?
  • ユーザー体験:ハンドオフ中、ユーザーには何が表示されますか?

ハンドオフの種類

  • 逐次型:エージェント A が作業を終え、結果をエージェント B に渡し、エージェント B が続けます。リレー競走のようなものです。
  • 並列ファンアウト:1 つのエージェントが複数のエージェントにサブタスクを同時に割り当てます。
  • 並列ファンイン:複数のエージェントの結果が 1 つのエージェントに集まり、統合されます。
  • エスカレーション:エージェントがタスクに対応できず、より高性能なエージェントまたは人間に引き継ぎます。
  • フォールバック:プライマリエージェントが失敗し、バックアップが引き継ぎます。
  • 人間へのハンドオフ:AI がレビュー、判断、または完了のために作業を人間に引き継ぎます。

コンテキストの引き継ぎ

ハンドオフで最もよくある失敗は、コンテキストの喪失です。何を引き継ぐかを設計しましょう。

  • 完全なコンテキスト:送信元のエージェントが把握していたすべての情報です。安全ですが、多すぎる可能性があります。
  • 要約されたコンテキスト:重要な情報を絞り込んだものです。効率的ですが、重要なニュアンスを失うリスクがあります。
  • 構造化されたコンテキスト:必ず入力する必要がある事前定義済みのフィールドです。一貫性がありますが、柔軟性に欠けます。
  • 差分コンテキスト:前回のハンドオフ以降に新たに加わった情報のみです。継続的なコラボレーションに効率的です。

ユーザーを考慮した設計

ハンドオフにおけるユーザー体験は重要です。

  • シームレスなハンドオフ:エージェントが交代したことをユーザーは知りません。途切れのない体験になります。
  • 透明性のあるハンドオフ:新しいエージェントが引き継ぐこととその理由をユーザーに伝えます。
  • 参加型ハンドオフ:ユーザーがハンドオフを確認するか、追加のコンテキストを提供します。
  • ユーザー主導のハンドオフ:ユーザーが別のエージェントまたは人間への引き継ぎを明示的に依頼します。

ハンドオフのアンチパターン

  • ブラックホール:作業が引き継がれますが、誰にも着手されません
  • エコーチェンバー:エージェント同士が進展のないまま作業をやり取りします
  • コンテキストの断絶:重要な情報がハンドオフで失われます
  • 唐突な移行:ハンドオフの時点でユーザー体験が大きく変わります
  • 無言のリダイレクト:ユーザーは引き継ぎが行われたことを知らず、変化に戸惑います

設計成果物

  • ハンドオフプロトコルの仕様(トリガー、送信元、送信先、ペイロード、確認応答)
  • コンテキスト引き継ぎ用テンプレート
  • ハンドオフのシーケンス図
  • ハンドオフの種類ごとのユーザー体験仕様
  • ハンドオフの障害モード分析

コメント