Dynamic workflows

Dynamic workflows は、Qoder CLI で構造化された multi-agent プロセスをバックグラウンド実行するための機能です。段階的な実行、大きな fan-out、クロスチェック、再利用可能な手順が必要なタスクに適しています。 Workflow は orchestration plan を JavaScript スクリプトに移します。スクリプトは、どの子 Agent を起動するか、作業をどのフェーズに分けるか、中間結果をどう統合するか、最終的に何をセッションへ返すかを決定します。

Workflows を使う場面

使い方	適した場面
Subagent	1つの集中的なサブタスク。メイン会話には要約だけ返せばよい場合。
Skill	再利用可能な指示、ドメイン知識、またはメイン Agent が従うべき手順。
Workflow	多数の子 Agent、フェーズ、分岐、検証パスを含む再利用可能な orchestration。

単一の Agent 呼び出しより大きいタスクには workflow を使います。たとえば、リポジトリ監査、広範な調査、移行計画、リリースチェック、複数ファイルのスイープ、複数の独立した視点を統合するレビューです。

Workflows でできること

機能	説明
Scripted orchestration	ループ、分岐、フェーズ、中間状態を workflow script に保持します。
Multi-agent fan-out	独立した作業単位に対して複数の子 Agent を起動します。
段階的な実行	scan、analyze、verify、summarize などの名前付きフェーズで進捗を表示します。
並列または pipeline 処理	独立した分岐を並列実行するか、各項目を段階的に処理します。
バックグラウンド実行	workflow を起動した後も Qoder CLI を使い続けられます。
再利用	よく使う手順を project、user、plugin、built-in workflow として保存できます。

Workflow を実行する

自然言語で Qoder CLI に workflow の使用を依頼できます。

Use a workflow to review this repository for security risks and summarize findings.

保存済みまたは built-in workflow を名前で依頼することもできます。

Use the deep-research workflow to investigate the tradeoffs of this architecture decision.

Qoder CLI は現在の依頼に合わせて workflow を作成するか、タスクに合う保存済み workflow を使用します。動的に生成された workflow は、実行前に計画が表示されます。実行、raw script の確認、フィードバック付き拒否、キャンセルを選べます。 Workflow はバックグラウンドタスクとして実行されます。起動後、Qoder CLI は workflow run ID を返し、進捗をタスク UI に表示します。

Workflow を確認する

TUI で /workflows を使うと workflow タスクパネルを開けます。

/workflows

パネルでは、実行中および完了済みの workflow、状態、フェーズ、Agent、ログ、出力パス、エラー、最終結果を確認できます。/tasks でも他のバックグラウンドタスクと一緒に workflow タスクが表示されます。 Workflow の実行中は、詳細画面で個々の Agent を確認できます。選択中の Agent がまだ制御可能な場合は、その Agent を skip または retry できます。

Workflow を保存する

保存済み workflow は名前で再利用できます。Qoder CLI は次の場所から workflow を検出します。

スコープ	場所	用途
Project	`.qoder/workflows`	現在のリポジトリまたはチーム向けの workflow。
User	`~/.qoder/workflows`	個人用で、複数プロジェクトから使う workflow。
Plugin	Plugin が提供する workflows	プラグインと一緒に配布される workflow。
Built-in	Qoder CLI built-ins	Qoder CLI が提供する workflow。

同じ名前がある場合、project workflow は plugin や built-in workflow より優先されます。チームで共有する手順は project workflow に、リポジトリへコミットしない個人用手順は user workflow に置きます。保存済み workflow は、先頭で meta オブジェクトを export する JavaScript ファイルです。metadata は名前、説明、フェーズ、任意の使用場面や input schema を Qoder CLI に伝えます。

export const meta = {
  name: "repo-audit",
  description: "Audit a repository area and summarize risks",
  whenToUse: "Use when the user asks for a structured repository audit",
  phases: [
    { title: "Scan", detail: "Find relevant files and areas" },
    { title: "Analyze", detail: "Run focused analysis agents" },
    { title: "Summarize", detail: "Merge findings into a final report" }
  ]
};

.qoder/workflows/repo-audit.js に保存した後、次のように依頼できます。

Run the repo-audit workflow for the authentication module.

保存済み workflow は args で入力を受け取れます。対象パス、issue ID、調査質問、オプションなど、実行ごとに変わる値を script を編集せずに渡せます。

Workflow の実行方式

Workflow scripts は通常の JavaScript です。agent()、parallel()、pipeline()、phase()、log()、workflow()、args、budget などの workflow helper を使えます。

Qoder CLI がタスクに対して保存済み workflow を選択するか、動的 workflow を作成します。
確認が必要な場合、workflow 名、フェーズ、script、実行オプションが表示されます。
Workflow がバックグラウンドタスクとして起動します。
Script が子 Agent を起動し、フェーズにグループ化します。
中間結果はメイン会話ではなく workflow runtime に保持されます。
最終結果は workflow run output に書き込まれ、現在のセッションに要約されます。

Workflow の scripts、manifest、journal、transcripts、出力は .qoder/sessions 配下の現在のセッションディレクトリに保存されます。

権限と安全性

Dynamic workflows は複数の子 Agent を実行し、token を速く消費する場合があります。大きい workflow や高コストな workflow を検証する場合は、小さい範囲から始めてください。 Workflow スクリプトは shell、ファイルシステム、ネットワーク、Node.js API、MCP サーバーへ直接アクセスできません。副作用は子 Agent を通じて発生し、その Agent は Qoder CLI のツール、権限、Hooks、サンドボックス設定を通過します。 workflow の子 Agent が実行できる内容は Permissions で制御できます。ツール呼び出しの前後に組織固有のポリシーを適用するには Hooks を使用してください。

​Workflows を使う場面

​Workflows でできること

​Workflow を実行する

​Workflow を確認する

​Workflow を保存する

​Workflow の実行方式

​権限と安全性