qoder-delegate

Qoder Delegate

あなたはオーケストレーターです。範囲を限定したコーディングタスクを、別の実装担当者である Qoder CLI に委任し、生成された内容をレビューして、自分で取り込みます。依頼内容を作成して判断の責任を持ちます。Qoder はセッション内で作業ツリーを編集し、あなたが検証してコミットします。

この一連の手順に必要なのはシェルとファイルへのアクセスだけなので、同等のオーケストレーターであれば実行できます。

使用しない場合

• タスクがインラインで実行できるほど小さく、委任のオーバーヘッドに見合わない場合。
• qodercli がインストールされていないか、認証されていない場合。
• 自分でコードを書きたい場合や、対話型の Qoder セッションだけが必要な場合。

前提条件（最初に一度だけ確認）

command -v qodercli
qodercli --version
qodercli --list-models

バイナリが見つからない場合は、Qoder の 公式クイックスタートからインストールしてください。qodercli login で認証するか、自動化の場合は QODER_PERSONAL_ACCESS_TOKEN を設定してください。--list-models が正常に実行されれば、現在のアカウントが最新のモデルカタログを取得できることを確認できます。

モデルとコンテキストウィンドウを選択する

Qoder で利用できるモデルは変更される場合があります。人間からモデルの指定があった場合は、qodercli --list-models から現在の正確な値を使用してください。カタログの項目を決して推測したり、固定したりしないでください。それ以外の場合は --model を省略し、Qoder の現在のデフォルトを使用します。

--context-window <n> は任意です。人間からサイズの指定があった場合、またはタスクに明示的な予算が必要な場合に限り、正の整数を渡してください。Qoder は対応モデルにのみこれを適用します。対応していないモデルやサイズのエラーが発生した場合は、別の値を黙って選ぶのではなく、そのエラーを伝えてください。

一連の手順

タスクごとに、次の 5 つの手順を実行します。手順 1、4、5 では判断が必要ですが、2 と 3 は定型作業です。

1. 依頼内容を作成する

Qoder が参照できるのは、依頼内容とワークスペース内で確認できる情報であり、このチャットの内容ではありません。目標、現在の状態、変更する内容、変更せずに残す内容、プロジェクトの実際のゲート、最後に提出するレポートの要件を含めてください。Qoder にはコミットしないよう伝えてください。依頼 1 件につきタスクは 1 つにしてください。 references/writing-the-brief.mdを参照してください。

2. 実行を依頼する

Codex でバックグラウンド作業をオーケストレーションする場合は、まず別個のサポートユーティリティである codex-backgroundをインストールして設定してください。その MCP ツールまたはレジストリが見つからない場合は、セットアップが必要であることを報告して停止してください。モデル駆動のポーリングに黙ってフォールバックしないでください。その後、以下のシェル例の代わりに、登録済みの delegate_run MCP ツールを一度呼び出してください。 共通引数の構造化、プロバイダーフラグの変更禁止、runId による再接続については、そのスキルに従ってください。完了するまでリクエストを保留状態にし、その後、このスキルのレビューと取り込みの手順を続けてください。それ以外のオーケストレーターは、以下のシェルワークフローを使用してください。

同梱のリレーを使用してください。Qoder の非対話型 stream-json モードをラップし、result.json を書き込みます。<skill-dir> は、この SKILL.md を含むインストール済みフォルダーです。

node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo
# choose a live model:                 add --model "<value from qodercli --list-models>"
# request a supported context window: add --context-window 32768
# resume the latest session:          add --resume-last  # delta brief only
# resume a specific session:          add --resume <id>  # delta brief only
# see every option:                   node .../relay.mjs --help

実装の実行では、デフォルトで Qoder の auto 権限モードが使用されます。呼び出し元が明示的に要求しない限り、リレーが権限を回避することはなく、コミットも行いません。 references/dispatch-and-poll.mdを参照してください。

3. 完了を待つ

codex-background を使用する Codex は、元の MCP リクエストを保留状態に保ちます。モデル駆動のスリープ、ステータスのポーリング、ログのポーリングは行いません。中断されたリクエストへの再接続には、delegate_wait のみを使用してください。

リレーは Qoder が終了するまで処理をブロックします。オーケストレーターのバックグラウンドコマンド機能を使って実行するか、シェルでバックグラウンド実行して result.json を待ってください。完了とは、プロセスが終了し、ファイルに status が含まれていることを指します。進行状況の表示を信用しないでください。

ネイティブ Windows でのリレー起動はまだ検証されていません。ネイティブ Windows でのスモークテストに合格するまでは、検証済みと主張しないでください。

4. レビュー - 自己申告を鵜呑みにしない

Qoder の最終メッセージとゲートの結果は、あくまで申告として扱います。

• プロジェクトのゲートを自分で再実行します。
• touchedFiles から始めて、ブリーフと差分を照合します。
• --add-dir のワークスペースがあれば個別に確認します。その変更はプライマリツリーのレポートには含まれません。
• インストールされている場合は、関連するガードスキルを実行します。
• マイグレーションを往復させ、削除や名前変更の後に参照先のない記述がないか grep で確認します。

references/review-and-land.md を参照してください。

5. コミットする

実装者が編集し、オーケストレーターがコミットします。ゲートに合格し、差分に問題がないことを確認してからコミットします。手直しが必要な場合は、--resume-last または --resume <id> を使って差分ブリーフを送り、再度レビューします。

権限モデル

Qoder の print モードでは承認プロンプトを表示できません。リレーはデフォルトで auto に設定され、非対話型の許可／拒否を判断します。default はプロンプトが必要なアクションを拒否することがあります。accept_edits はワークスペースの編集を許可しますが、シェル操作を拒否することがあります。dont_ask はフェイルクローズし、plan は default と Qoder の Plan 作業状態に対応します。bypass_permissions は、明示的に信頼された実行でのみ使用します。

信頼されたディレクトリ以外でデフォルト以外のモードが要求されると、Qoder は default にフォールバックします。result.json の actualPermissionMode を確認してください。要求したモードによって差分レビューが不要になることはありません。

承認モデル

委任するかどうかは、人間が選択します。委任を依頼された後は、検証済みでゲートに合格した作業をコミットすることが合意事項です。制限が 2 つあります。表面化し、取り込まない（Qoder の設計上の判断と、ブロッキングではない逸脱を報告する）こと、そしてスコープ変更時には停止する（ブリーフの範囲を超えて拡張する前に確認する）ことです。references/review-and-land.md を参照してください。

参考資料

• references/writing-the-brief.md - ブリーフの構成、実際のゲート、レポートの契約、シークレット、差分ブリーフ。
• references/dispatch-and-poll.md - フラグ、モデル／コンテキストの制御、成果物、結果フィールド、セッション、障害からの復旧。
• references/review-and-land.md - 独立したレビュー、コミットの境界、手直し。
• references/multi-task-queues.md - 順次キュー、制約の引き継ぎ、進捗管理、最終的な一貫性。