mcpField
O
orchestrate

orchestrate

github.com/cursorエージェントワークフロー14.5k1.2k 回インストール今日更新
リポジトリ

orchestrate について

orchestrateは、大規模なタスクを複数のCursorクラウドエージェントに分配するCursorスキルです。プランナーが作業を割り当て、構造化された引き継ぎをもとに次の作業を決めます。

主な機能

  1. 01Cursorクラウドエージェントの並列実行
  2. 02プランナーとワーカーの役割
  3. 03構造化された引き継ぎ
  4. 04JSONプランの実行
  5. 05Slackでの任意のステータス更新

活用シーン

  1. 01大規模なコーディングタスクの分割
  2. 02サブプランナーによる階層的なタスク調整
  3. 03Slackを設定した場合の進捗確認

インストール

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

$npx skills add https://github.com/cursor/plugins --skill orchestrate

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

同梱ファイル

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

prompts/
andon-block.md
empty-error-handoff.md
failure-handoff.md
finished-no-handoff.md
loop-hygiene.md
root.md
slack-block.md
subplanner.md
verifier.md
worker.md
references/
dispatcher.md
handoffs.md
planner.md
spawning.md
schemas/
plan.schema.json
state.schema.json
scripts/__tests__/
agent-manager-slack-mirror.test.ts
andon-root-cache.test.ts
checkpoint-restart.test.ts
comment-cli.test.ts
comment-retry-queue.test.ts
exit-on-error.test.ts
failure-handoff.test.ts
handoff-branch-parser.test.ts
handoff-verification-parser.test.ts
handoff-verification-record.test.ts
kickoff-dedupe.test.ts
measurements-compare.test.ts
measurements-mismatch.test.ts
measurements-parser.test.ts

詳細

Orchestrate

明示的な /orchestrate <goal> により、大規模なタスクが複数の Cursor クラウドエージェントに並行して割り振られます。ワーカー同士は連絡を取り合わず、構造化された引き継ぎを通じて上位に報告します。起動、待機、引き継ぎのループは scripts/cli.ts にあります。プランナーが plan.json を作成し、スクリプトがそれを実行して、プランナーが引き継ぎ内容を読んで次の作業を決定します。長時間実行されるエージェントのループは逸脱しがちですが、JSON の状態ファイルを使うスクリプトなら、軌道を保てます。

必読:cursor-sdk スキル(cursor/plugins/cursor-sdk)。 起動、認証、エラー分類については、そちらに記載されています。そのスキルで説明済みの内容を再実装しないでください。

セットアップ

  • CURSOR_API_KEY には個人用/ユーザー用のキーが必要です。Cursor ダッシュボード > Integrations で作成し、使用する前に cursor-sdk の Auth を読んでください。
  • SLACK_BOT_TOKEN は任意です。設定されている場合は、kickoff または最初の run --root に --slack-channel <id> を渡すか、SLACK_CHANNEL_ID を設定します。スクリプトはチャンネルを plan.slackChannel に保存し、そこでキックオフスレッドを投稿してタスクのステータスを反映し、アンドンのリアクションを読み取ります。トークンが設定されていない場合、スクリプトはその旨を一度だけログに記録し、Slack での可視性なしで実行します。正確性には影響しません。

基本原則

これらのルールにより、全体で調整しなくてもツリーが自律的に収束します。

  1. プランナーはスコープを管理し、タスクを公開します。コーディングはしません。 plan.json の作成、引き継ぎ内容の確認、次の作業の決定はプランナーの役割です。ファイルの編集、git merge の実行、競合のその場での修正はプランナーの役割ではありません。コーディングしたくなったら、代わりにワーカー向けのタスクを公開します。
  2. プランナーは、誰がタスクを担当するか把握しません。 スクリプトが各タスクをクラウドエージェントに割り当てます。プランナーはタスク単位で考えます。
  3. ワーカーは隔離されています。 1 つのタスクにつき、リポジトリのクローンは 1 つ。他のエージェントとの連絡手段はありません。完了時に引き継ぎを 1 回行います。
  4. サブプランナーは再帰的なプランナーです。 プランナーは「この範囲のサブプランを作成する」タスクを公開します。サブプランナーはその範囲を全面的に担当し、集約した引き継ぎを返します。
  5. 引き継ぎによって継続的に進行します。 完了したと思っていたプランナーにも、遅れて引き継ぎが届いて再計画が必要になることがあります。プランナーが公開をやめると決めるまで、「完了」状態にはなりません。
  6. 同期ではなく伝播です。 兄弟間の連絡はありません。階層間で状態を共有することもありません。各階層が参照できるのは、子からの引き継ぎだけです。

ノードの種類

ノードループを実行するかスコープ出力
プランナーはいユーザーの目標全体ユーザー向けメッセージ + 任意の PR
サブプランナー(↻)はい親のスコープのうち 1 つの範囲親への引き継ぎ
ワーカーいいえ具体的なタスク 1 つ起動元のプランナーへの引き継ぎ
検証担当いいえ1 つの対象の受け入れ基準起動元のプランナーへの判定引き継ぎ
Git該当なし共有媒体ブランチ(コード)+ handoffs/(内容)

役割

役割は 2 つ、スキルは 1 つです。自分の役割のリファレンスファイルを読み、もう一方は読み飛ばしてください。

ディスパッチャー。 ローカルの IDE セッションで、ユーザーが /orchestrate <goal> を入力しました。あなたの仕事は、クラウドルートプランナーを起動し、その URL を返すことです。references/dispatcher.md を参照してください。これは一度限りの処理であり、あなたはプランナーではありません。

プランナー(ルートまたはサブ)。 「You are the root planner for:」または「You are a subplanner for:」で始まる構造化プロンプトを受け取って起動されました。または、ユーザーがローカルで計画ループを実行することを選びました。スコープを管理し、タスクを公開し、引き継ぎを読み、次の作業を決定します。references/planner.md を参照してください。

disable-model-invocation: true は、このスキルが明示的な呼び出し時にのみ読み込まれることを意味します。

コメント