| name | herdr-chat |
| description | herdr を介して、ユーザー・Claude Code・Copilot CLI・copilot-quorum の四者が
pane 越しに対話するためのプロトコル。相手 pane の見つけ方、宛先プレフィックス付き
メッセージ形式、送信・応答待ちの手順、ループ防止の原則を定める。
ユーザーが「Copilot と相談して」「quorum に合議させて」「他のエージェントに聞いて」
「隣の pane と話して」などと言った時、または他エージェントからの宛先付きメッセージ
(【from→to】形式)を pane 上で検知した時に使う。
司令塔↔作業者プロトコル(herdr スキルの `agent send` / 上り報告)とは別物 — あちらは
上下関係の報告経路、こちらは対等な対話。既存プロトコルは変更しない。
|
herdr-chat — 四者会話プロトコル
herdr の pane を介して、ユーザー・Claude Code・Copilot CLI・copilot-quorum が
対等な立場で会話するためのプロトコル。前提として herdr スキルの基本操作
(pane list / pane send-text / pane send-keys / wait output など)を理解していること。
参加者モデル
| 参加者 | 実体 | 役割 |
|---|
| ユーザー | 任意の pane に直接入力 | 最優先。全エージェントはユーザー入力を最優先で扱う |
| Claude Code | pane (多くは commander-* または agent 名付き) | 対話 + herdr 操作のハブ |
| Copilot CLI | herdr agent start した pane | 対等な対話相手 |
| copilot-quorum | Agent REPL pane | 合議が欲しい論点を投げる「合議体」。単独モデルの応答ではなく Quorum→Peer Review→Synthesis の結論を返す |
1. 参加者の発見
会話を始める前に、必ず herdr agent list と herdr pane list --workspace <ws> で
相手 pane を特定する。宛先を推測でメッセージを送らない — pane id はセッションごとに
変わりうるため、送信直前に毎回確認する。
herdr agent list
herdr pane list --workspace <workspace_id>
agent フィールドが claude のものは herdr がエージェント検知している。Copilot CLI /
copilot-quorum は agent: null / agent_status: unknown になるため、name フィールド
(herdr agent start <name> ... で付けた名前)で区別する。名前を付けずに起動された pane は
cwd や直近の agent read の内容で人間側が判断してから送る- 宛先誤送信の防止: 送信直前に対象 pane を
herdr agent read <target> で読み、
想定した相手(Copilot のプロンプト、quorum の solo> 入力欄など)が実際にそこにいるか
確認してから send-text する。特に同一 workspace 内に複数の作業用 pane がある場合、
pane id の取り違えは容易に起こる
- 自分自身の workspace 外の pane(他ユーザー・他司令塔のもの)には触れない
2. メッセージ形式
宛先プレフィックスを本文の先頭に付ける:
【<from>→<to>】<本文>
from / to は次のいずれか: claude / copilot / quorum / user
例:
【claude→copilot】このコードのレビューをお願いします
【copilot→claude】レビューしました。src/foo.rs:42 が気になります
【claude→quorum】キャッシュ戦略をLRUにするかTTLにするか合議してください
【quorum→claude】Quorum結論: TTL推奨(理由は3点)
ユーザーが pane に直接入力する場合、プレフィックスは省略されうる。プレフィックスの
有無に関わらず、pane への直接入力は常にユーザー入力として最優先で扱う(5節)。
3. 送信: 2段構え
pane send-text は挿入のみで実行されない。必ず send-keys <pane-id> Enter を続ける:
herdr pane send-text <pane_id> "【claude→copilot】疎通確認です"
herdr pane send-keys <pane_id> Enter
4. 応答待ち: wait output + 応答マーカー
自己エコーの罠: 送信文に含まれる文字列で wait output すると、応答より先に
自分の入力行のエコーにマッチする。応答待ちは応答マーカー込みのパターンで行う
(相手ごとの応答マーカーは 6 の一覧表を参照)。
herdr wait output <pane_id> --match "● " --timeout 30000
herdr agent read <pane_id>
複数ターンでのラベル使い回しの罠(copilot-quorum で実測): Agent: のような
固定ラベルは会話が進むと画面内に複数回出現する。2ターン目以降に単純にラベルだけで
--match すると、直前ターンの古い応答に即マッチしてしまい、新しい応答を待たない。
2ターン目以降は、応答本文にのみ出現する一意なトークンを相手への質問文で指定させ
(例: 「回答には一意な合言葉 <トークン> を含めてください」)、応答側にしか出ない
プレフィックス(Agent: など)とトークンの複合パターンで --match --regex する:
herdr wait output <pane_id> --match "Agent:.*<トークン>" --timeout 30000 --regex
トークン単体でのマッチは避ける — トークンだけだと質問文中の記載や入力エコー行にも
一致しうる。トークン自体は送信文(質問文)に含めてよいが、マッチは必ず応答側の
プレフィックス込みの複合パターンで行うこと。
5. ユーザー最優先の原則
ユーザーからの直接入力(プレフィックスの有無に関わらず、pane 上での直接入力)を検知したら、
進行中の他エージェントとの対話より優先してそれを処理する。他エージェントとの対話中に
ユーザー入力が割り込んだ場合、対話を打ち切ってユーザーの用件に応答してよい。
6. ループ防止の原則
四者会話は自動転送や無条件応答を許すと容易に無限ループする。以下を厳守する:
- 自分宛にのみ応答する: pane 上のメッセージを読み、宛先プレフィックスが
→<自分> になっているものにのみ応答する。宛先が他者宛のメッセージは読んでも
反応しない(黙って無視する)
- 受信メッセージの自動転送を禁止する: 受け取った内容をそのまま他の pane に
右から左へ転送しない。他者に伝える必要がある場合は、自分の判断を通した要約・
言い換えとして送る
- 応答は1メッセージにつき1回: 同じ受信メッセージに対して複数回応答しない。
応答済みかどうか、直前に自分がそのメッセージへ返信済みでないかを確認してから送る
- 上記を満たしていても会話が3往復以上続きそうな場合は、一度ユーザーに状況を報告し
継続の是非を確認する(合議や長考が必要な論点は quorum に投げる判断も含めて)
7. 参加者ごとの起動方法と応答マーカー
| 参加者 | 起動コマンド | 応答マーカー | 終了方法 | 備考 |
|---|
| Claude Code | herdr agent start <name> --workspace <ws> --split down（または right） -- claude | herdr の agent_status(idle/working)で検知可能。文字列で待つ場合はプロンプト行 > | pane 内で /exit または pane close | Claude 同士は wait agent-status が使える(herdr が正式にエージェント検知する) |
| Copilot CLI | herdr agent start <name> --workspace <ws> --split down -- copilot | ● (行頭。応答本文の先頭に付く) | 入力欄に /exit + Enter | herdr はエージェント検知しない(agent=null/agent_status=unknown)。wait output のパターンマッチで代替する |
| copilot-quorum | herdr agent start <name> --workspace <ws> --split down -- copilot-quorum --no-quorum | Agent: ラベル行(初回のみ。2ターン目以降は 4 のトークン方式を使う) | send-keys <pane_id> C-c(pane ごと片付く。実測確認済み) | 引数なし起動で Agent REPL。--no-quorum で合議レビューをスキップ(軽い疎通確認向け)。/discuss でアドホック合議、省略時 --ensemble で全問合議になる。応答完了は画面上部ステータスが Planning→Ready に変化し、System: Agent completed の直後に Agent: ラベルが出る |
copilot-quorum プローブの実測ログ(2026-07-11 JST, w2W:p3 で実施)
起動: herdr agent start quorum-probe --workspace w2W --split down -- copilot-quorum --no-quorum
送信: herdr pane send-text w2W:p3 "疎通確認です。「プローブOK-qz9」とだけ一言返してください。"
herdr pane send-keys w2W:p3 Enter
1ターン目応答(5秒後): Agent: プローブOK-qz9 ← ラベル `Agent:` で初検出
2ターン目: 同じ「Agent:」でwait outputすると直前ターンの行に即マッチ(新規性なし) ← 罠を確認
終了: herdr pane send-keys w2W:p3 C-c → pane 自体が消滅(pane list から w2W:p3 が消える)
8. セットアップ
Copilot CLI に herdr コマンドの実行を許可する
Copilot CLI のツール許可は ~/.copilot/permissions-config.json の
locations.<絶対パス>.tool_approvals に永続化される。対話モードで herdr ... の
実行時に「常に許可」を選ぶと、そのロケーション(cwd の絶対パス)に対して自動的に
{"kind": "commands", "commandIdentifiers": ["herdr"]} が書き込まれる。
このファイルは Nix では管理しない。理由:
- キーが worktree ごとに異なる絶対パスであり、worktree を作るたびにエントリが増える
動的な性質を持つ。home.nix のような宣言的シードと相性が悪い
- Copilot CLI 自身が対話操作で書き換える実行時状態ファイルであり、シードで固定内容を
書くと CLI 側の管理と競合しうる
運用手順: 新しい worktree で Copilot CLI から herdr コマンドを初めて実行する際は、
対話プロンプトで一度「常に許可」を選ぶ(以後そのディレクトリでは自動承認される)。
非対話的に起動する場合は copilot --allow-tool='shell(herdr:*)' をセッション起動時に
明示する。無理に自動化しない。
