Claude Dynamic Workflows
MadoHub 如何检测、可视化并驾驭 Claude Code 自带的并行子 Agent 功能。
Dynamic Workflows 是 Claude Code 自身 的研究预览功能——Anthropic 自家的多 Agent 编排机制，不是 MadoHub 构建的。Claude Code 可以把一个会话扇出成许多并发子 Agent，一起处理同一个问题。
MadoHub 在其之上提供一层兼容层。MadoHub 不创建也不运行这些子 Agent——它检测它们、在 workflow 运行期间保持自己的 Agent 状态模型正确，并给你一种看到进展的方式，而不会像朴素集成那样淹没在噪音里。没有这层，一个 65 个子 Agent 的 workflow 意味着一个图块上堆 65 个完成徽章，每个都要单独消除。
你在 Claude Code 会话里通过在 prompt 里输入 ultracode、运行 /effort ultracode、或在 Pro 计划的 /config 里打开 Workflows 开关来触发 Dynamic Workflows。它需要较新的 Claude Code 版本；自然语言触发需要更新的版本。
MadoHub 在其中做什么
- 检测某 Claude Code 图块上正在跑 workflow，把子 Agent 事件聚合成每图块一个进度计数，而不是每个子 Agent 一个徽章。
- 在三个地方显示进展 —— Context Gauge 的活跃指示（一个小脉动点）在图块上亮起，Fleet 面板在该行下显示
workflow · 3/5 agents，Context Gauge 提示框显示聚合的 workflow token 数字。 - 把 workflow token 用量与主计量百分比分开 —— 子 Agent 跑在各自上下文，不是主会话窗口，所以它们的 token 用量与主会话填充分开跟踪。
- 同一图块上开始新 run 时重置计数，第二次 workflow 不会继承第一次的累计。
如何使用
你不会直接"使用"MadoHub 的兼容层——你在 Claude Code 图块里使用 Claude Code 的 Dynamic Workflows 功能，MadoHub 自动呈现进展。
- 打开一个 Claude Code 图块，在会话里触发一个 workflow（输入
ultracode、运行/effort ultracode、或在/config里打开 Workflows 开关）。 - workflow 运行时留意图块的 Context Gauge 活跃指示亮起。
- 在 Fleet 面板看该图块行下的
workflow · {done}/{seen} agents行，不必飞到图块就能看到扇出进展。 - 悬停图块的 Context Gauge 看聚合 workflow token 数字，与主百分比分开附加。
- workflow 结束时活跃指示熄灭，进度行自动消失。
Claude 自身的限制
这些是 Claude Code 的限制，不是 MadoHub 的，MadoHub 无法改变：
| 限制 | 值 |
|---|---|
| 最大并发子 Agent | 16（CPU 受限的机器更少） |
| 每个 run 最大子 Agent | 1,000 |
| 运行时是否接受用户输入 | 不接受——只有权限 prompt 能暂停一次 run |
常见用例
- "跨多个子 Agent 跑一个大研究任务。" —— 在 Claude Code 里触发 workflow，从 Fleet 面板看扇出进展，不必离开手头工作。
- "那个 workflow 还在跑吗？" —— Context Gauge 的脉动点和提示框里的
(active)后缀一眼告诉你。 - "workflow 在烧多少 token？" —— 悬停 Context Gauge；workflow token 数字与主会话填充分开显示。
提示与最佳实践
- 看 Fleet 面板的
workflow · {done}/{seen} agents行来跟扇出进展，而不是飞到图块——兼容层的全部意义就是不让你被每个子 Agent 的徽章淹没。 - workflow token 数字刻意与主计量百分比分开跟踪。不要把它们相加来估算"总上下文"——子 Agent 跑在各自上下文里。
- 一个刚启动的 workflow 在首个 usage 块落地前可能显示为活跃但 token 为零。给它一点时间。
- workflow 结束后，Claude Code 会写入权威总数；MadoHub 直接读那个数而不是重新汇总子 Agent 文件，所以最终数字比运行中的更准。
相关功能
- Context Gauge —— 每图块填充条，其活跃指示和提示框呈现 workflow 进展。
- Fleet —— 每行显示
workflow · {done}/{seen} agents的面板。 - MadoAgent —— MadoHub 自己的多 Agent 模式（Ensemble Exploration、Orchestrator Mode）。
局限
- Dynamic Workflows 是 Claude Code 的研究预览功能。MadoHub 检测并可视化它；MadoHub 不实现它。
- MadoHub 在此读取的一切都是 Claude Code 为自身目的写入的观察行为，不是公开契约。Anthropic 可能随着该功能走出研究预览而未经通知地更改格式。
- workflow 运行时不接受用户输入——只有权限 prompt 能暂停一次 run。触发前请据此规划。