handoff-protocols について
handoff-protocolsは、エージェント間およびエージェントと人間の間の引き継ぎを設計するスキルです。引き継ぎの流れ、コンテキスト転送、ユーザー体験、失敗パターン、設計成果物を扱います。
主な機能
- 01引き継ぎの契機、送信元、宛先、確認
- 02逐次、並列、エスカレーション、フォールバック
- 03コンテキスト転送の方式
- 04ユーザー向け引き継ぎ体験のパターン
- 05失敗パターンと設計成果物
活用シーン
- 01エージェント間でタスクを渡す条件と手順の定義
- 02引き継ぎ時のコンテキスト情報の設計
- 03ユーザーに見える引き継ぎやエスカレーションの計画
- 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 がレビュー、判断、または完了のために作業を人間に引き継ぎます。
コンテキストの引き継ぎ
ハンドオフで最もよくある失敗は、コンテキストの喪失です。何を引き継ぐかを設計しましょう。
- 完全なコンテキスト:送信元のエージェントが把握していたすべての情報です。安全ですが、多すぎる可能性があります。
- 要約されたコンテキスト:重要な情報を絞り込んだものです。効率的ですが、重要なニュアンスを失うリスクがあります。
- 構造化されたコンテキスト:必ず入力する必要がある事前定義済みのフィールドです。一貫性がありますが、柔軟性に欠けます。
- 差分コンテキスト:前回のハンドオフ以降に新たに加わった情報のみです。継続的なコラボレーションに効率的です。
ユーザーを考慮した設計
ハンドオフにおけるユーザー体験は重要です。
- シームレスなハンドオフ:エージェントが交代したことをユーザーは知りません。途切れのない体験になります。
- 透明性のあるハンドオフ:新しいエージェントが引き継ぐこととその理由をユーザーに伝えます。
- 参加型ハンドオフ:ユーザーがハンドオフを確認するか、追加のコンテキストを提供します。
- ユーザー主導のハンドオフ:ユーザーが別のエージェントまたは人間への引き継ぎを明示的に依頼します。
ハンドオフのアンチパターン
- ブラックホール:作業が引き継がれますが、誰にも着手されません
- エコーチェンバー:エージェント同士が進展のないまま作業をやり取りします
- コンテキストの断絶:重要な情報がハンドオフで失われます
- 唐突な移行:ハンドオフの時点でユーザー体験が大きく変わります
- 無言のリダイレクト:ユーザーは引き継ぎが行われたことを知らず、変化に戸惑います
設計成果物
- ハンドオフプロトコルの仕様(トリガー、送信元、送信先、ペイロード、確認応答)
- コンテキスト引き継ぎ用テンプレート
- ハンドオフのシーケンス図
- ハンドオフの種類ごとのユーザー体験仕様
- ハンドオフの障害モード分析
コメント
Markdown 対応