Claude Code 动态工作流（Dynamic Workflows）调研报告

📋 概述

动态工作流（Dynamic Workflows）是 Claude Code 在 2.1.154 版本（2026年5月28日）引入的重大功能，允许 Claude 编排数十甚至数百个后台 subagent 并行执行任务，适用于超出单个 agent 能力范围的大型复杂工作。

当你描述一个超出单个 turn 能力范围的任务时，Claude 会自动生成一个工作流脚本，在后台启动多个 subagent 协同工作，交叉验证彼此的发现，最终汇总结果。

🎯 代码库全面审计 📁 500+ 文件迁移 🔍 交叉验证研究 📐 多角度方案规划

🧠 核心概念

什么是动态工作流？

传统 Claude Code 交互是turn-by-turn（逐轮判断）的——你说一句，Claude 做一步。动态工作流则不同：一个脚本持有完整计划，Claude 根据计划调度大量 subagent 并行执行，无需你介入每个步骤。

与 Subagents 的区别

维度	Subagents	Dynamic Workflows
协调者	Claude turn-by-turn 决定	脚本持有计划，Claude 执行计划
规模	少数几个并行 agent	数十到数百个 agent
适用场景	侧任务、上下文隔离	超出单个 pass 能力的大型任务
结果验证	单一结果输出	多 agent 交叉验证结果
监控方式	/agents 查看 Running	/workflows 查看阶段和完成数

与其他并行模式的对比

并行模式	协调者	worker 间通信	适用场景
Subagents	Claude（单 session 内）	结果返回主对话	侧任务，不希望干扰主对话
Agent View	你手动 dispatch	只汇报给你	多个独立任务，想监控进度
Agent Teams	Claude 作为 lead	共享任务列表 + 互发消息	实验性，Claude 分任务给 worker
Dynamic Workflows本次重点	脚本持有计划	交叉验证，结果互相检查	超大型任务，需要多角度验证

🚀 使用方式

触发方式

在对话中自然描述你的大型任务，Claude 会识别出需要动态工作流。例如：

# 自然语言触发（推荐）
审计整个代码库的潜在安全漏洞，对每个模块分别分析，最后汇总报告

# 或使用 ultracode 触发词（2.1.160+）
ultracode 将这个 500 文件的模块从 JavaScript 迁移到 TypeScript
  

⚠️ 注意：触发词从 workflow 变更为 ultracode（v2.1.160，2026年6月2日）。之前输入 workflow 会直接触发，现在需要用自然语言描述需求，或直接说 ultracode。

监控工作流

# 查看所有运行中和已完成的工作流
/workflows
  

监控界面显示：

每个工作流当前处于哪个 phase（阶段）
已完成多少个 agent
正在运行 / 已完成 / 失败的状态

🎯 实战场景与具体案例

🛡️ 场景一：代码库安全漏洞审计

适用规模：大型代码库（100+ 文件） | 预期规模：50-200 个 agent

审计整个代码库的潜在安全漏洞，将代码库按模块分组，每个 subagent 负责分析一个模块，检查 SQL 注入、XSS、敏感信息泄露、权限绕过等常见漏洞，最后交叉验证各模块的发现，排除误报，生成统一的安全报告

执行流程：
Phase 1：按模块分区，启动 N 个 agent 并行扫描
Phase 2：汇总各模块发现，过滤重复/误报
Phase 3：交叉验证高危漏洞，多个 agent 重审可疑项
Phase 4：生成统一报告，按严重程度分级

📁 场景二：500+ 文件大规模迁移

适用规模：大型重构（500+ 文件） | 预期规模：100-500 个 agent

ultracode 将这个 300 文件的前端模块从 JavaScript 迁移到 TypeScript，每个子目录由一个 agent 负责，agent 之间检查类型兼容性和接口一致性问题，最后汇总迁移状态报告

执行流程：
Phase 1：分析依赖图，按层级分组（底层 → 中间层 → 上层）
Phase 2：先处理无依赖模块，并行启动批量 agent
Phase 3：后续层级的 agent 等待依赖模块完成后启动
Phase 4：汇总类型错误、接口不一致、迁移覆盖率统计

🔍 场景三：多假设并行 Bug 调查

适用场景：疑难 Bug（根因不明） | 预期规模：5-20 个 agent

用户报告 app 在收到特定消息后崩溃，生成多个 agent 分别调查不同假设：假设 A（网络解析问题）、假设 B（状态管理竞态）、假设 C（内存泄漏触发）、假设 D（日志模块缺陷），每个 agent 用不同角度分析日志和代码，最终交叉验证哪个假设最可能是根因

执行流程：
Phase 1：4 个 agent 并行调查 4 个不同假设
Phase 2：各 agent 汇报找到的证据和置信度
Phase 3：lead 综合分析，标记矛盾之处
Phase 4：最可能的假设提交修复方案，附置信度说明

✅ 场景四：多维度 PR 代码评审

适用场景：大型 PR，多人评审 | 预期规模：3-10 个 agent

创建一个 agent team 来评审 PR #142，生成三个评审 agent：一个专注于安全影响，一个检查性能问题，一个验证测试覆盖率，每个 agent 从不同角度审查同一 PR，最终 lead 综合三方发现，生成统一的评审报告

执行流程：
Phase 1：3 个 agent 并行各自审查
Phase 2：lead 汇总三方发现，去重
Phase 3：对矛盾结论再次验证
Phase 4：生成按优先级排序的评审意见

🏗️ 场景五：多角度架构方案评审

适用场景：新系统设计，需要多视角验证 | 预期规模：5-15 个 agent

为新的微服务架构设计方案进行多角度评审，生成 5 个 agent 分别从：可扩展性、安全合规、性能成本、运维复杂度、团队技术栈匹配度等角度评估方案，最终交叉验证各角度的优缺点，给出综合推荐

执行流程：
Phase 1：5 个专家 agent 并行分析
Phase 2：汇总各角度的潜在风险
Phase 3：识别相互矛盾的设计决策
Phase 4：生成权衡矩阵和推荐方案

📚 场景六：遗留代码库全面理解

适用规模：大型遗留系统（200+ 文件） | 预期规模：50-200 个 agent

对这个 10 年历史的遗留代码库进行全面分析，每个 agent 负责一个子系统（认证、订单、支付、通知等），深入理解其设计模式和业务规则，最后汇总成一份统一的数据字典和架构图，并标注需要优先重构的高风险模块

执行流程：
Phase 1：按子系统分区，并行分析
Phase 2：各 agent 输出子系统概要和数据字典
Phase 3：交叉验证跨模块依赖关系
Phase 4：生成全局架构图和高风险模块优先级

📖 使用门槛与最佳实践

使用门槛

⚠️ 模型要求：动态工作流需要 Claude Opus 4.8 或更高版本。Haiku/Sonnet 无法使用。触发时会检查模型是否支持，不支持则报错。

同时建议开启 思考模式（thinking），让 Claude 在规划阶段有更多推理空间。

最佳实践

原则	说明
任务可拆分	任务必须能自然拆分为独立子任务，子任务之间尽量减少依赖
结果可验证	子任务的结果应该能客观评估，适合交叉验证
明确完成标准	脚本需要知道任务何时算完成，要有明确的终止条件
避免过细拆分	单个 agent 的任务不要太细碎，否则协调开销大于收益
监控 `/workflows`	大型工作流耗时较长，定期用 `/workflows` 检查进度

适用条件检查清单

✅ 适合用 Dynamic Workflows

任务规模大（50+ 子任务）
子任务之间相对独立
需要多角度验证结果
任务可以自动化判断完成
愿意消耗更多 token

❌ 不适合用 Dynamic Workflows

任务之间强依赖顺序
需要实时人工反馈
小规模任务（5 个以下）
高度探索性任务
相同文件的并行编辑

⚙️ 技术细节

版本历史

2026-05-28 · v2.1.154

首次发布 — 引入 Dynamic Workflows，触发词为 workflow；同步发布 Opus 4.8

2026-06-02 · v2.1.160

触发词变更 — 将 workflow 触发词改为 ultracode；新增 Workflow keyword trigger 设置，可禁止 "workflow" 词触发

2026-06-08 · v2.1.169

稳定性改进 — /workflows 现在立即打开，即便当前有 turn 在进行中

工作流结构

动态工作流本质是一个脚本化的多阶段计划：

每个阶段（phase）可包含多个并行 subagent
阶段之间可以有依赖关系（前序完成才继续）
结果在阶段结束时汇总，下一阶段基于此继续
支持交叉验证：多个 agent 结果互相检查

与 /effort 的关系

在 v2.1.160 中，/effort ultracode 的错误提示被修正——之前会错误地归因于 dynamic workflows 设置，现在明确提示 ultracode 仅适用于支持 xhigh 的模型。

📊 总结

一句话定位：动态工作流让 Claude 能够承担超出单轮对话能力的大型复杂任务，通过脚本化计划协调数十至数百个 subagent 并行工作、交叉验证结果。

6 大实战场景

🛡️

安全漏洞审计

50-200 agent 并行

📁

大规模代码迁移

100-500 agent 并行

🔍

多假设 Bug 调查

5-20 agent 并行

✅

多维度 PR 评审

3-10 agent 并行

🏗️

架构方案评审

5-15 agent 并行

📚

遗留代码理解

50-200 agent 并行

一句话总结

当任务规模超出 5-10 个 subagent 的协调能力、需要交叉验证结果、或任务本身太复杂无法单轮完成时，Dynamic Workflows 是正确的选择。