動的ワークフローで大規模にサブエージェントをオーケストレーションする

​

ワークフローを使用するタイミング

​

バンドルされたワークフローを実行する

/deep-research What changed in the Node.js permission model between v20 and v22?

/workflows

​

バンドルされたワークフロー

​

実行を監視する

​

Claude にワークフローを書かせる

• プロンプトでワークフローをリクエストする。自分の言葉で、またはキーワード ultracode を含めることで、Claude がそのタスク用のワークフローを書きます。
• ultracode で Claude に決めさせる。/effort ultracode を設定すると、Claude がセッション内のすべての実質的なタスク用にワークフローを計画します。

​

プロンプトでワークフローをリクエストする

ultracode: audit every API endpoint under src/routes/ for missing auth checks

​

キーワードを無視するか、オフにする

​

キーワードが機能する場所

• -p で渡されたプロンプト
• Agent SDK アプリケーションが人間の入力としてスタンプせずに送信するプロンプト
• スケジュールされたタスクプロンプト
• ウェブフック ペイロードまたはプルリクエストコメントが会話にリレーされた場合

​

ultracode で Claude に決めさせる

/effort ultracode

• 「Large workflow」警告はワークフロー実行に表示されません
• セッションの同時サブエージェント制限は、Claude が Agent ツールで生成するサブエージェントに対して強制されません
• 自動権限モード では、ワークフロー起動を承認するよう求められません

​

実行前にプランを承認する

• Yes, run it: 実行を開始する
• Yes, and don’t ask again for <name> in <path>: 開始し、このプロジェクトでこのワークフローに対してこのプロンプトをスキップします。Claude Code は、現在のタスク用に Claude が書いたスクリプトではなく、バンドルされた、保存された、またはプラグインワークフローを名前で実行する場合にこのオプションを提供します。
• View raw script: 決定する前にスクリプトを読む
• No: キャンセル

• 権限ルール: 許可ルール内の Workflow はすべてのワークフローを承認し、Workflow(<name>) は名前で 1 つの保存されたワークフローを承認します。
• 自動権限モード: 分類器は呼び出しをレビューし、それを承認できます。
• バイパス権限モード: Claude Code は呼び出しを承認します。
• フック: 呼び出しを許可する PreToolUse フックがそれを承認します。
• ホスト: --permission-prompt-tool、または Agent SDK では canUseTool コールバックがそれを承認します。

​

再利用するためにワークフローを保存する

• プロジェクト内の .claude/workflows/。リポジトリをクローンする全員と共有されます
• ホームディレクトリ内の ~/.claude/workflows/。すべてのプロジェクトで利用可能で、あなたにのみ表示されます。CLAUDE_CONFIG_DIR を設定した場合、この場所はそのパスの下の workflows/ ディレクトリです。

• プロジェクト場所: .claude、.claude/workflows、またはターゲットファイルがシンボリックリンクの場合、Claude Code は拒否します。
• 個人用の場所: Claude Code はターゲットファイル自体がシンボリックリンクの場合のみ拒否するため、ドットファイルツールで管理される ~/.claude ディレクトリは引き続き機能します。

​

プラグインでワークフローを配布する

​

保存されたワークフローに入力を渡す

Run /triage-issues on issues 1024, 1025, and 1030

​

ワークフローの実行例プロンプト

​

同じ問題について多くのファイルを監査する

use a workflow to audit every route handler under src/routes/ for missing authentication checks, and adversarially verify each finding before reporting it

​

チェックが合格するまで修正を続ける

use a workflow to run npx tsc --noEmit and keep fixing the reported errors until the type check passes or two rounds in a row make no progress

​

多くのファイルを並列でマイグレーションする

use a workflow to migrate every component under src/components/ from JavaScript to TypeScript, working on each file in its own isolated copy

​

すべての変更されたファイルをレビューして 1 つのサマリーを作成する

use a workflow to review every file changed in this PR for correctness issues, then merge the per-file findings into one ranked summary

​

多くのソースにわたってトピックを研究する

use a workflow to research how our three competitors handle rate limiting: read their public docs and recent changelog entries in parallel, then compare the approaches

​

リストが成長を停止するまで問題を見つける

use a workflow to find flaky tests in this repo: run the suite repeatedly, record which tests fail intermittently, and stop once two rounds in a row find nothing new

​

保存されたスクリプトの外観

export const meta = {
  name: 'audit-routes',
  description: 'Audit every route handler for missing auth checks',
}

const found = await agent('List every .ts file under src/routes/.', {
  schema: { type: 'object', required: ['files'], properties: { files: { type: 'array', items: { type: 'string' } } } },
})

const audits = await pipeline(found.files, file =>
  agent(`Audit ${file} for missing authentication checks.`, { label: file }),
)

return audits.filter(Boolean)

​

保存されたスクリプトを編集する

• meta ブロック: export const meta を最初のステートメントとして保持し、name と description を持つプレーン オブジェクト リテラルとして保持します。変数、関数呼び出し、スプレッドなどのリテラル値以外のものが含まれている場合、Claude Code は / オートコンプリートから /<name> を削除します。
• 本体: agent()、pipeline()、parallel() の他に、phase() を呼び出して、進捗ビューのタイトルの下に続くエージェントをグループ化し、log() を呼び出してフェーズの上にメッセージを表示し、args グローバルを読み取ることができます。本体に構文エラーがある場合、Claude Code はワークフローを実行するときにそれを報告します。
• phases: meta にそれらをリストする場合、phase() に渡す各エントリに正確にタイトルを付けます。エントリのない phase() タイトルは独自の進捗グループを取得します。
• タイムスタンプとランダム性: Claude Code はスクリプト内で Date.now()、Math.random()、および引数なしの new Date() をスローするため、再開された実行は同じ agent() 呼び出しを繰り返します。代わりに args を通じてタイムスタンプを渡します。

​

ワークフローの実行方法

​

ファンアウトでのプロンプトキャッシング

​

動作と制限

​

ランを管理する

​

一時停止後に再開する

• 完了: 保存された結果を返します。スクリプトを編集したか、前のエージェントが異なる結果を返したため、プロンプトが前回の実行と異なる最初のエージェントが再度実行され、その後のすべてのエージェント（完了したものも含む）も実行されます。
• 停止時にまだ実行中: 最初からやり直します。ラン全体を停止しても、どのエージェントも失敗とはカウントされません。
• 失敗: 再度実行され、その後に開始したすべてのエージェント（完了したものも含む）も実行されます。/workflows でエージェントを選択して x を押すことで 1 つのエージェントだけを停止することは、失敗とカウントされます。

• セッションをバックグラウンドにする場合、Claude Code はバックグラウンドセッションで同じ方法でランを再生し、それを続行します。
• エージェントビューがオンの状態で Claude Code を終了しながらワークフローが実行中の場合、終了ダイアログは Move to background and exit を提供し、ランを同じ方法で引き継ぎます。代わりに Exit and stop tasks を選択するか、オプションが提供されない場合、ランはセッションで停止します。Claude Code はランの保存された結果を ~/.claude/projects/ のそのセッションのディレクトリの下に保持するため、claude --resume で再開するセッションは、Claude にワークフローを再起動するよう依頼するときにそれらを再生できます。新しく開始するセッションでは、Claude は再起動する前のランを持たず、ワークフローを新しいランとして最初から開始します。

​

ランが使用制限に達したとき

• セッションはインタラクティブで、claude.ai サブスクリプションでサインインしています。非インタラクティブモードで claude -p または Agent SDK を使用する場合、バックグラウンドセッション、または Remote Control または エージェントチームのチームメイトセッションではランは一時停止しません。
• autoContinueAtUsageLimit がオンで、セッション自体が 使用制限がリセットされるのを待つことができる同じ設定です。待機中にオフにすると、待機が終了し、待機中のエージェントは失敗します。
• 制限は 24 時間以内にリセットされます。週単位の制限はさらに先にリセットされる可能性があります。
• ランはまだ 2 回待機していません。3 回目に制限に達すると、エージェントは失敗します。

​

エージェントが停滞して再起動するとき

• agent stalled on all 6 attempts: すべての試行がウィンドウ全体の間、出力なしで経過しました。エージェントの作業がそれほど長く出力を伴わないものである場合は、ウィンドウを長くしてください
• agent lost its reply on all 6 attempts: すべての試行の応答ストリームが途絶え、Claude Code がその待機を諦めました。ストリーミングアイドルウォッチドッグが先に応答を終了させたため、停滞ウィンドウを長くしても効果はありません。そのウォッチドッグのタイムアウトは CLAUDE_STREAM_IDLE_TIMEOUT_MS で設定します
• agent abandoned after 6 attempts: 試行がそれぞれ異なる方法で終了しました。エラーにはそれらが順番に列挙されます

• 1 つのエージェント: その agent() 呼び出しでミリ秒単位の stallMs を渡します。たとえば 30 分なら agent(prompt, { stallMs: 1800000 }) です
• すべてのエージェント: CLAUDE_ASYNC_AGENT_STALL_TIMEOUT_MS を設定します。これはワークフロー外のサブエージェントにも適用されます

• parallel() または pipeline() 内: ランはエージェントの結果の代わりに null を使用して続行されます
• 直接 await した場合: ランはエラーで終了します

​

コスト

• サイズガイドラインを自分で選択する場合、そのエージェント数は 25 エージェント閾値を置き換えます。組み込みのデフォルトガイドラインは閾値を 25 のままにします。
• ultracode がオンのセッションは警告を表示しません。ultracode をオンにすることで既に大規模なランにオプトインしているためです。

• 通常のルーチン作業のために小さいモデルに切り替える場合は、大規模なランの前に /model を確認してください
• タスクを説明するときに、最も強力なものを必要としないステージに対して小さいモデルを使用するよう Claude に依頼してください

​

サイズガイドラインを設定する

​

ワークフローをオフにする

• /config で Dynamic workflows をオフに切り替えます。セッション間で保持されます。
• ~/.claude/settings.json で "disableWorkflows": true を設定します。セッション間で保持されます。
• CLAUDE_CODE_DISABLE_WORKFLOWS=1 を設定します。起動時に読み込まれるため、設定した場所に適用されます。

• /workflows、ワークフローコマンド、/workflow-authoring スキルは利用できなくなります
• ultracode キーワードはランをトリガーしなくなり、Ultracode トグルは /effort から削除されます

​

関連リソース

• エージェントを並列実行：サブエージェント、エージェントビュー、エージェントチーム、ワークフローを比較
• カスタムサブエージェントを作成：ワークフローがオーケストレーションするワーカープリミティブ
• コストを管理：マルチエージェント実行が使用制限にカウントされる方法