Flows

Flow 是一个可复用的画布子图：一组 Agent 图块加上它们之间的连接，存为模板，每次放下时全新实例化。不必每次手工生成两个 Agent 再重新配置连接的 trigger、transform 和循环保护设置，选一次 Flow 就能一个动作拿到整组已连好的子图。

Flows 位于 MadoHub 编排选项的"快捷模板"一端。挑一个 Flow 用于现成模式，需要自定义编排时请用 MadoAgent（⌘⇧M），或自己在图块之间拖拽以手工连一条一次性连接。

三个内置 Flow

这三个始终存在，不能删除或覆盖。放下一个，得到的正是你自己生成两个 Agent 图块、按该预设设置画一条连接所能得到的结果。

你能用它做什么

• 一个动作放下已连好的 Agent 配对 —— 选一个 Flow、输入任务 prompt，图块和连接就出现并已连好。
• 保存你自己的 Flow —— 把当前画布上每个 Agent 图块及其间的连接捕获成新 Flow，以后可放下。
• 重新放下以原地刷新 —— 把同一个 Flow 放到已有一个活跃实例的框架上，会原地刷新该实例而不是复制图块。
• 接入已有空闲 Agent —— 当同一项目下已有同类型空闲 Agent 时，Flow 会接入它而不是堆叠重复。
• 带或不带任务 prompt 启动 —— kickoff 时发送 prompt，或只加空 Flow 由你自己往每个图块里输入。

如何使用

1. 打开右侧抽屉的 Flows 标签。
2. 点一个 Flow（内置或已保存）。kickoff 对话会先问你要任务 prompt。
3. 输入任务，然后：
   • 按 Cmd+Enter（或点 Start with task）实例化 Flow 并把 prompt 发给入口 Agent。
   • 点 Add without task 实例化 Flow 但不发送任何内容。
   • 点 Cancel 什么都不创建。
4. Flow 的入口 Agent 在其 CLI 报告 ready 后立即收到你的 prompt。

要保存你自己的 Flow，点 Flows 面板底部的 + Save canvas as flow。只有运行已识别 Agent（Claude、Codex、Amp 或 OpenCode）的图块会被捕获；裸 shell 或无类型图块会被跳过。保存空画布（无已识别 Agent 图块）会被 toast 拒绝。

常见用例

• "合并前同行评审这个 PR。" —— 放下 Peer review flow，把 PR 描述作为任务输入，Author 和 Reviewer 循环直到 LGTM。
• "生成测试，然后跑测试。" —— 放下 Pipeline flow，Claude 在 Stage 1 生成测试，Codex 在 Stage 2 跑测试。
• "盯着开发服务器日志，出问题时告诉我。" —— 放下 Watcher flow 指向日志；watcher agent 看到 error、warn 或 fail 时作出反应。

提示与最佳实践

• kickoff 时总是发送任务 prompt——不发的话你会落到空终端，得手动往每个里输入。
• 重新放下一个 Flow 到它自己的活跃实例上是原地刷新而不是复制图块。用这个方式重启 Flow 而不在画布上散布副本。
• 如果你发现自己在重建同一个多图块布局，那是 工作空间模板，不是 Flow。Flow 用于可复用的双 Agent 模式。
• 当同一项目下有同类型空闲 Agent 时，Flow 会接入它，所以你不必先清理重复。

相关功能

• MadoAgent —— Flow 不适用时的自然语言自定义编排。
• Connections —— Flow 的 trigger 和 transform 实际做了什么。
• Workspace Templates —— 整张画布的快照，不只是 Agent 配对。
• Right Drawer —— Flows 标签所在之处。

局限

• Flow 只捕获运行已识别 Agent（Claude、Codex、Amp、OpenCode）的图块。裸 shell 和无类型图块会被跳过。
• 内置 Flow 不能删除或覆盖。
• kickoff 最多等 20 秒入口 Agent 被检测为 ready，之后仍会写入 prompt；Amp 和 OpenCode 因无前端 ready 信号，固定有 5 秒启动宽限。