mcpField
C
cline-delegate

cline-delegate

github.com/amelnagdyエージェントワークフロー2.5k3.1k 回インストール2 週間前に更新
リポジトリ

cline-delegate について

cline-delegateは、範囲を限定したコーディングタスクをCline CLIに委任し、成果を確認してコミットするためのスキルです。独立した概要をリレーで渡して構造化出力を記録し、検証はオーケストレーターが行います。

主な機能

  1. 01独立したタスク概要による委任
  2. 02JSONイベントの取得と結果ファイル
  3. 03モデルとプロバイダーの選択
  4. 04読み取り専用計画と承認制御
  5. 05確認・検証後にコミットする手順

活用シーン

  1. 01Gitリポジトリ内の範囲限定変更の委任
  2. 02実装前の読み取り専用計画
  3. 03変更の確認とプロジェクトチェックの再実行
  4. 04未完了タスクを修正済み概要で再委任

MCP 対応

Codexのバックグラウンドオーケストレーションでは、別途codex-backgroundを設定し、そのdelegate_run MCPツールを呼び出すよう案内します。それ以外ではシェルのリレーを使います。

インストール

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

$npx skills add https://github.com/amelnagdy/delegate-skills --skill cline-delegate

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/
dispatch-and-poll.md
multi-task-queues.md
review-and-land.md
writing-the-brief.md
scripts/
relay.mjs

詳細

Cline Delegate

あなたはオーケストレーターです。範囲を限定したコーディングタスクを、別の実装担当者であるClineコーディングエージェントCLIに委任し、その成果をレビューして自分で取り込みます。依頼内容を作成し、判断の責任を担うのはあなたです。実装担当者はクリーンな作業ツリーで独自のセッションを使って変更を行い、あなたが検証してコミットします。

このループに必要なのはシェルコマンドとファイルアクセスだけなので、同等のオーケストレーターであればどれでも実行できます。

使用しない場合

  • タスクがインラインで実行できるほど小さい場合。委任にかかる手間に見合いません。
  • cline CLI がインストールされていない、または認証されていない場合。
  • リレーにサンドボックスの設定を求める場合。Cline はサンドボックス制御を公開していますが、このリレーではCLI環境に任せています。読み取り専用で実行する必要がある場合は、--plan を使用してください。

前提条件(一度だけ確認)

  1. cline をインストールします(npmまたはバンドル済みバイナリ。リレーは cline --version を実行して確認します)。
  2. 認証します。cline auth を実行して対話形式でサインインするか、ANTHROPIC_API_KEY またはOpenAI互換のベースURLを設定します。
  3. cline --version が正常に実行されることを確認します。
  4. 対象のgitリポジトリ内で作業するか、--cd でそのリポジトリを指定します。

モデルを選択する(任意)

Cline はデフォルトモデルを選択します。別のモデルを選ぶには、個別に --model <id> または --provider <name>(例:anthropic、openai-native、openrouter)を渡します。リレーが受け付けるのは英字、数字、および . _ : / - のみです(Windowsでは値がシェルに渡されます)。

ループ

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

1. 依頼内容を作成する

Cline が参照できるのは、あなたが送信したテキストだけです。会話の内容は読めないため、依頼内容だけで完結させ、目標、現在の状態、変更する箇所、変更せずに残す箇所、プロジェクトで実際に必要なチェック項目、および報告内容を明記してください。各依頼は単一のタスクに限定します。ファイルに書き込み、リレーの --brief に渡してください。references/writing-the-brief.md を参照してください。

2. 実行を指示する

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

バンドル済みのリレーを使用します。リレーは cline --json -v を実行し、固定の位置引数指示文に続けて標準入力から依頼内容を渡し、JSONイベントストリームを取得して result.json に書き込みます。

node "<skill-dir>/scripts/relay.mjs" --brief brief.txt --cd /path/to/repo
# choose a model / provider:        add --model <id>  --provider <name>
# read-only planning pass:          add --plan   (forces --auto-approve false)
# deny approval-required tools:     add --auto-approve false
# hard time limit (watchdog):        add --timeout 2h   (the 30m default suits brief runs; most implementation briefs should be 1-2h)
# see all options:                   node .../relay.mjs --help

子プロセスのcwdでワークスペースが固定されます。リレーはデフォルトで成果物をシステムの一時ディレクトリに書き込み、コミットは行いません。references/dispatch-and-poll.md を参照してください。

3. 完了を待つ

codex-backgroundを使用するCodexでは、元のMCPリクエストを保留したままにします。モデル主導のスリープ、ステータス確認、ログのポーリングは行いません。中断されたリクエストに再接続する場合に限り、delegate_wait を使用します。

リレーはclineの処理が終わるまでブロックします。オーケストレーターのバックグラウンドコマンド機能を使って実行するか、シェルでバックグラウンド実行し、result.json をポーリングしてください。実行前の使用方法エラーが発生するとコード2で終了し、結果は書き込まれません。cline が見つからない場合はコード127で終了し、status: "cline_unavailable" が書き込まれます。

完了とは、プロセスが終了し、result.json が存在する状態です。進捗表示ではなく、プロセスの状態と作業ツリーを信頼してください。Cline の最終メッセージは result.json の finalMessage フィールドにあります。

4. レビューする — 自己申告を鵜呑みにしない
  • プロジェクトのチェック項目を自分で再実行します。
  • touchedFiles から確認を始め、依頼内容と照らし合わせて差分を読みます。
  • インストールされている場合は、関連するガードスキルを実行します。

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

5. 仕上げる

作業に問題がなければ、コミットします。リレーはコミットしません。差分と result.json が記録になります。まず git status と git diff を実行し、変更内容を正確に確認してください。グループに PR のフローがある場合は、コミットしてブランチをプッシュし、人間によるレビューを受けます。差分に誤りがある、または不完全な場合は、新しい実行で修正したブリーフを再度ディスパッチし、もう一度レビューします。

自律性と権限

リレーは Cline の --auto-approve を明示的に渡し、act モードではデフォルトで true にします。Cline の plan モードでは act モードへの切り替えを要求できるため、--plan は --auto-approve false を強制します。リレーは --plan --auto-approve true を拒否します。この組み合わせが読み取り専用の制御です。Cline は --data-dir / CLINE_SANDBOX を通じてサンドボックスも提供しますが、リレーはこれを設定も上書きもしません。リスクのある作業では、まず plan モードで実行し、別途 act モードでディスパッチする前に計画をレビューしてください。コマンドは現在のユーザーとして実行されるため、不正なブリーフや悪意のあるブリーフは act モードでは依然として危険です。

承認モデル

委任するかどうかは、人間が選択します。ブリーフを渡した後、cline は使用を承認したツールとして動作します。境界は、自己申告による結論を受け入れず、ディスク上ですべてを確認することです。認証情報、本番データ、取り消せない操作に関わる場合は、ブリーフに含めるのではなく、いったん停止して人間に確認してください。

参考資料

コメント