agent-bridge

agent-bridge — ピアコーディングエージェントに委任する

あなたはリードエンジニアです。このブリッジを通じて、独自のハーネスを自動モードで実行しているピアコーディングエージェント（Claude Code、Codex など）に、自己完結した作業を任せることができます。大規模な作業にも対応し、実装、テスト、自身の成果の検証まで完了してから報告します。

このブリッジは、あなたがどのエージェントなのか、どのピアを呼び出せるのかを自動検出します。自分自身に委任することはありません。自分自身のサブエージェントを使ってください。

誰を呼び出せますか？

bash "$HOME/.agents/skills/agent-bridge/scripts/bridge.sh" agents

このマシンで利用できるピア（あなた以外の全員）を一覧表示します。以下のコマンドで <peer> として1つ選んでください。特定のピアの注意点については、このスキルの references/<peer>.md を参照してください。

覚えておくべき命名上の例外があります。「Gemini」はピア agy を指します。Google は Gemini CLI の後継の名称を Antigravity CLI に変更したため、「Geminiに聞いて」（または「Antigravityに聞いて」）と指定すると agy が対象になります。

委任する方法

現在作業しているプロジェクトのルートから実行します。

bash "$HOME/.agents/skills/agent-bridge/scripts/bridge.sh" <peer> "your task for the peer"

• ピアの推論とアクションがリアルタイムでストリーミングされます。実行中に内容を確認してください。
• 実行ごとの完全なトランスクリプトは、そのピアの logs/ に保存されます。状態は ~/.agent-bridge/projects/<project>/<you>/<chat>/<peer>/<thread>/ のグローバルストアに保存されるため、管理は不要です。スレッドはデフォルトで main です。スレッド名を指定するのは、ピアを並行して実行するときだけです（下記の並行委任を参照）。
• ピアが混乱した場合や、ユーザーからやり直すよう求められた場合は、リセットして再試行してください。下記のピアを最初からやり直すを参照してください。

時間のかかるタスクや、$、バッククォート、引用符を含むタスクは、ファイルに書き出して --task-file で渡してください。argv では渡さないでください。 argv は最初にシェルを通るため、プロンプト内の $12B は 2B になり、ピアに誤った指示が渡されます。- は標準入力を読み込みます。これで文字列の破損は防げますが、サイズの問題は解決しません。約120KBを超えるとブリッジは受け付けません（タスクは引き続き argv としてピアに渡されます）。その場合は、ピアにファイルを直接読むよう指示してください。

bash "$HOME/.agents/skills/agent-bridge/scripts/bridge.sh" <peer> --task-file brief.md

初回の実行前に、以下の注意点を読んでください。「止まっているように見える」ケースのほとんどは、ピアが思考中です。

注意点

• 思考中は停止しているように見えますが、実際には停止していません。 最初のアクションの前やアクションの合間に、ピアは数分間推論することがあります。· thinking… ~Nk tokens のハートビートと増加するカウントを出力するピアもあれば、· exec: / · tool: のアクション行を継続的に表示するピアもあります。いずれもピアが作業中であることを示しています。出力が流れている間は、中断、終了、再起動しないでください。介入するのは、ストリームが長時間完全に途絶えた場合だけです。
• ピアの最終回答は ── <peer> done ── マーカーの後に表示されます。 その前に表示されるのは、すべてリアルタイムの推論とアクションです。ストリームを確認しつつ、マーカーの後のテキストを回答として扱ってください。回答の後に続くものが1つあります。それは、ピアがリポジトリではなく自身のプライベートなセッションディレクトリにファイルを書き出した場合に表示される ── <peer> artifacts ── の一覧です（agy が生成した画像などが該当します）。記載されたパスは実在するファイルです。残しておきたいものをプロジェクトにコピーしてください。
• ピア自身の成果に関する報告は、結果ではなく主張です。 伝える前に自分のツールで確認してください。ピアは、実際には満たしていない制約まで満たしたと報告することがあります。
• セッションは会話、ピア、スレッドごとに保持されます。 新しいチャットを始めると、ピアのセッションも新しくなります。このチャット内では、同じピアへの呼び出しはすべて、同じスレッド（スレッド名を指定しない場合は main）で継続されます。追加の指示は、最初から説明し直すのではなく、「先ほど作成したパーサーは末尾の数値を取りこぼします。修正してテストを再実行してください」のように、継続として伝えてください。
• 1つのスレッドで実行できるのは一度に1つだけです。 委任直後に「already has a run in progress」というエラーが表示された場合、そのスレッドで別の実行が進行中です。完了を待つか、自分で --thread ラベルを指定してください。（クラッシュ後に古いロックが残っても、自動的に検出・解除されます。）

推論の強さ

ピアはデフォルトで**high**の推論レベルで動作します。さらに強く、または軽く推論させるには、--effortを指定します。

bash "$HOME/.agents/skills/agent-bridge/scripts/bridge.sh" <peer> --effort <level> "your task"

レベルはlow・medium・high・xhigh・maxです（lowは高速で低コスト、maxは可能な限り深く推論します）。ユーザーの依頼を最も近いレベルに置き換えてください。たとえば、*「じっくり考えて／徹底して」ならhighまたはxhigh、「全力で」ならmax、「手早く／ざっくり／考えすぎないで」*ならlowです。ユーザーが推論の強さについて何も言わなければ、フラグは省略します（highが適用されます）。これらの正規レベルを必ず指定してください。ブリッジが各レベルをピア側の設定に対応付けます（ピアによっては上限が低い場合がありますが、これは想定どおりで、実行ヘッダーに表示されます）。

モデル

新しいスレッドでは、ブリッジはモデルフラグを指定しません。ピアは自身のCLIで設定されたモデルを使用します（すでにモデルが固定されたスレッドでは、そのモデルが再利用されます。詳細は後述）。ユーザーがモデルに言及しない場合は、これが適切です。モデルを選ぶのは、ユーザーがモデル名を挙げた場合、または明確に性能（「最強」、*「最安」*など）を求めた場合だけです。

bash "$HOME/.agents/skills/agent-bridge/scripts/bridge.sh" <peer> --model <model> "your task"

--modelには、ピアに依存しない値であるtop（ピアが提供する最も強力なコーディングモデル）、またはモデルの短縮名（例：sonnet、luna）を指定します。各ピアのモデル一覧はreferences/<peer>.mdにあり、アダプターが名前をピアのCLIで使われるモデル引数に変換します。認識されない値はそのままピアのCLIに渡されるため、正確なモデルIDや新しいモデルIDも使用できます。ユーザーの表現は自分で標準化してください。「Claudeの最良モデル」なら--model top、「codex astr」（誤記）なら--model astra、*「codexの最安モデル」*なら、そのピアのリファレンスノートにある最安モデルを指定します。

モデルと推論の強さは独立した設定です。--modelはモデルを、--effortは推論の強さを指定します。「手早く」、「徹底して」、*「考えすぎないで」*といった言葉で変えるのは、推論の強さだけです。ユーザーがモデルやコストの希望も示していない限り、そこから安価なモデルを推測しないでください。

**明示的に指定したモデルはスレッドに保持されます。**一度--modelを指定すると、そのスレッドでの後続の依頼では同じモデルが自動的に再利用されるため、フラグを繰り返し指定する必要はありません。後から別のモデルを指定するとスレッドが切り替わり、ヘッダーにswitching model old→newと表示されます。リセットすると、セッションとともにモデルの選択もクリアされます。

並列委任（スレッド）

デフォルトでは、ピアへのすべての呼び出しで1つのセッションを共有します。これによって後続の依頼をスムーズに処理できます。ただし、同じピアへの複数の委任が同時に実行される場合（たとえば、ブリッジをそれぞれ呼び出すヘルパーサブエージェントを起動する場合）、同じセッションを共有してはいけません。サブエージェントはチャットIDを引き継ぐため、分離しないと互いのコンテキストを再開して状態を上書きしてしまいます。並列処理の各レーンには、個別のスレッドラベルを付けてください。

bash "$HOME/.agents/skills/agent-bridge/scripts/bridge.sh" <peer> --thread worker-1 "task A"
bash "$HOME/.agents/skills/agent-bridge/scripts/bridge.sh" <peer> --thread worker-2 "task B"

• 委任を行うヘルパーサブエージェントを起動するときは、各ヘルパーに渡す正確なコマンドに、一意の--thread <label>を指定してください。ヘルパー自身では、並列処理の一部であることを判断できません。
• ラベルは任意です。worker-1、review、testsなどを指定できます（先頭は英字または数字にしてください）。
• 各スレッドは、それぞれ独立した永続的なピアセッションです。同じラベルでの後続の依頼は、そのセッションを引き継ぎます。
• クリーンな状態で作業を始めたいヘルパーは、自身のレーンだけをリセットしてください。<peer> reset --thread <its-label>を使い、すべてのスレッドのセッションが消去される<peer> resetだけの実行は避けてください。

有能なエンジニアとしてピアに依頼する

• **細かな手順ではなく、まとまった作業を任せてください。**機能全体、モジュール、リファクタリング、本格的なデバッグタスクなどです。1つの関数だけの小さな依頼に分割すると、やり取りが増え、能力を十分に活用できません。範囲を適切に定めた大きな作業を最後まで任せられ、報告前に自分で検証できるものとして扱ってください。
• **必要なコンテキストを最初にすべて伝えてください。**目的、関連ファイル、制約、成功の判断基準（実行するテスト、期待される動作）を含めます。依頼内容が十分に整っているほど、より大きな作業を任せられます。
• **範囲を明確にしてください。**過剰に踏み込んだり、途中で止まったりしないようにします。

ピアを活用する4つの方法 — 用途に合ったものを選びましょう

1. 実装担当 — 作業を任せて、実装、テスト、報告をしてもらいます。
2. 独立したレビュアー — あなたやピアが書いたものを、新鮮な目で確認してもらいます。 「X の変更を正確性とエッジケースの観点からレビューしてください。具体的にお願いします。」
3. 敵対的なレッドチーム — 設計を壊したり、最悪の不具合を見つけたりするよう試してもらいます。 「このパーサーが誤った結果を返す入力を見つけてください。」
4. 思考のパートナー — アイデア、設計、アプローチ、計画について意見を求めます。ブレインストーミング、批評、代替案の提案、計画の妥当性確認をしてもらえます。 「移行について、以下の計画を立てました。違う方法を取るとしたら、どうしますか？」

レビューでは、踏み込んだ質問をして、批評の妥当性を判断してください。意見が違うときは反論し、指摘が正しいときは受け入れましょう。強力な2つのモデルが意見を異にすることに意味があります。

ピアのセッションをやり直す

ピアのセッションは会話ごとに維持されるため、デフォルトではそのまま続行します。ただし、行き詰まったり混乱したりした場合や、ユーザーが 「新しいセッションを開始してもう一度試して」 のようなことを言った場合は、自分でリセットを実行してから、タスクを再度依頼してください。ユーザーにコマンドを入力させる必要はありません。

bash "$HOME/.agents/skills/agent-bridge/scripts/bridge.sh" <peer> reset                    # this peer, all threads
bash "$HOME/.agents/skills/agent-bridge/scripts/bridge.sh" <peer> reset --thread <label>   # one thread only
bash "$HOME/.agents/skills/agent-bridge/scripts/bridge.sh" reset                           # every peer, this chat

次の呼び出しでは、そのピアがまっさらな状態で開始します。他の会話には影響しません。影響を受ける委任タスクが実行中の場合、リセットは拒否されるため、処理の途中で実行が消えることはありません。ただし、並列ヘルパーを起動している間はリセットしないでください。まったく新しいスレッドが開始されてしまう可能性があります。

あなたが担うループの一部

• ピアから報告を受けた後は、受け入れる前に自分のツールで独自に確認してください（ファイルを読み、テストを実行します）。うのみにしないでください。
• 問題があれば、同じセッションで修正を委任するか、自分で修正してください。どちらにするかはあなた次第です。
• 作業が完了し、検証できたら、人間に短くまとめて伝えてください。何を実装したか、何を確認したか、未解決の点があるかを説明します。