Dynamic Workflows

Dynamic Workflows 与 Ultracode

使用 dynamic workflows 和 ultracode，通过可重复的 workflow scripts 编排大量 subagents。

Dynamic Workflows 是什么

Dynamic workflows 是 Claude Code 的大规模编排层。它不是让 Claude 一轮一轮地解决任务，而是让 Claude 写一个 workflow script：协调大量 agents，在主对话外保存中间结果，最后返回报告或结果。

适合需要广度、交叉验证或可重复编排的任务：

  • 审计大型代码库中的所有 routes、components、migrations 或 packages。
  • 同时跑多个研究分支，再比较结论。
  • 让 agents 互相验证发现后再汇报。
  • 把重复的多 agent 流程保存成命令。

Ultracode

Ultracode 是让 Claude 自动判断是否值得使用 dynamic workflow 的会话级方式：

text
/effort ultracode

开启后，Claude 会把 xhigh reasoning effort 和自动 workflow orchestration 结合起来。一个实质性请求可能变成连续几个 workflows：理解代码、实现变更、验证结果。

Ultracode 很强，但成本也高。它只在当前会话中生效。回到日常工作时切回：

text
/effort high

你也可以只为单个任务触发 workflow：

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

自然语言如 “use a workflow” 或 “run this as a workflow” 也可以 opt in。

Workflows 与 Subagents / Agent Teams 的区别

机制编排方式通信方式规模适合
Subagents主会话委托回报给 parent少量 workers上下文隔离
Agent teamsTeam lead 和 teammatesPeer messaging少量长期 peers实时协作
Dynamic workflowsScript runtime 协调 agentsScript 聚合结果每次运行几十到数百 agents审计、研究、迁移、交叉验证

关键区别是状态放在哪里。Subagent 和 team 的结果会回到 Claude 上下文。Workflow script 把中间状态保存在变量中，只把有用的最终结果交回主对话。

内置 Workflow：/deep-research

Claude Code 内置 /deep-research：

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

它会从多个角度展开研究，抓取并交叉验证 sources，过滤弱 claims，然后返回带引用的报告。

查看和管理运行

Workflows 在后台运行。用 /workflows 查看：

text
/workflows

在 workflow view 中，你可以查看 phases 和 agents，停止运行、恢复暂停的运行、查看 token usage，或把 script 保存成命令。

审批与权限

Workflow 开始前，Claude Code 可以展示计划 phases 并请求审批。具体提示取决于权限模式。

重要边界：

  • 在 default 和 acceptEdits 中，workflow run 通常启动前会询问，除非之前已批准。
  • 在 auto 中，第一次启动会记录 consent；ultracode 可以跳过启动提示。
  • 在 bypassPermissions、claude -p 和 Agent SDK 场景中，run 不会有交互式启动提示。
  • Workflow subagents 总是在 acceptEdits mode 下运行，并继承你的 tool allowlist，不受当前 session mode 影响。长 run 前先把需要的 shell commands、web fetches 和 MCP tools 加入 allowlist。

保存 Workflow 复用

如果 Claude 写出的 workflow 以后会重复使用，可以从 /workflows 保存。项目 workflow 放 .claude/workflows/；个人 workflow 放 ~/.claude/workflows/。

保存后会变成 slash command：

text
/api-auth-audit src/routes

适合保存为工程 ritual：安全扫描、发布就绪检查、迁移审计、跨 package 一致性扫描。

限制与取舍

Dynamic workflows 不只是“更多 agents”，而是另一种执行模型。

  • 比普通 turn 消耗更多 tokens 和时间。
  • 适合可并行拆分的任务。
  • 不适合运行中频繁需要人类判断的任务。
  • Workflow script 负责协调；agents 负责读写文件和执行 shell。
  • 单次 run 最多 16 个并发 agents，最多 1,000 个 total agents。
  • Run 可以在同一会话中 resume，但仍比普通 subagent 更重。

什么时候用什么

场景使用
“搜索这个 package 并汇报发现”Subagent
“前后端需要 peer discussion 协调”Agent team
“审计数百个文件并独立验证”Dynamic workflow
“每个实质性任务都自动选择编排方式”Ultracode
“每周重复这套编排”Saved workflow 或 routine

官方参考

继续实践

Dynamic Workflows 与 Ultracode 的核心概念已经读完

如果你想把理解变成可复用的能力，可以到 AgentWay 继续练习

进入练习