Workflow Toolbox：Claude Code 多智能体工作流的系统化构建工具箱

Workflow Toolbox 是一个面向 Claude Code Workflow 工具的多智能体工作流构建框架，提供七种经过验证的编排模式、编写脚手架和调试工具，帮助开发者构建可审计、可复现的多智能体工作流系统。

• 原作者/维护者：home-dev-lab
• 来源平台：GitHub
• 原始标题：workflow-toolbox
• 原始链接：https://github.com/home-dev-lab/workflow-toolbox
• 来源发布时间/更新时间：2026-06-13T13:47:29Z

---

Claude Code 的 Workflow 工具（研究预览版）允许开发者使用 JavaScript 脚本编排多个智能体的协作，而非依赖单一长对话完成所有任务。这种架构将循环、条件判断和并行执行等控制流交给确定性的代码处理，只有叶子节点的 agent() 调用才需要真正的智能推理，每个智能体在自己的独立上下文中运行。

然而，Workflow 工具本身提供的只是一个基础平台，开发者需要自行实现大量重复性机制：并行执行后的结果验证、合理的停止条件、结果数据的模式定义、对遗漏或截断的诚实记录等。手工实现这些机制容易在相同的微妙细节上出错，而且一个中途失败的智能体看起来和一个成功完成的智能体几乎无法区分。

Workflow Toolbox 正是为了解决这些痛点而设计的系统化工具箱，它将构建多智能体工作流的过程类比为搭建乐高积木。

@workflow-toolbox 是一个编译时 TypeScript 库，提供七种经过测试验证的编排模式，可以通过普通的 await/if/for 语句组合使用。这些模式包括：

• classifyAndAct：路由模式，一个分类器选择类别，然后恰好一个处理器执行
• fanOutAndSynthesize：并行分段模式，独立智能体并发运行，所有结果到达后才触发合成
• adversarialVerification：对抗性验证模式，每个声明面对独立验证者的反驳，未通过投票的声明被保留并标记为未验证
• generateAndFilter：生成-过滤模式，广泛生成后根据明确标准单次过滤，拒绝项被实时记录
• tournament：竞赛模式，多个不同角度的尝试，评委小组打分，合成阶段选取获胜者及亚军中的最佳想法
• loopUntilDone：带类型停止条件的迭代优化模式，支持 done/maxIterations/dryRounds/budgetFloor 四种停止条件
• planAndExecute：规划-执行模式，规划器将工作分解为不可预先预测的子任务，执行器完成子任务后合成结果

Claude Code 技能（位于 plugin/ 目录）教会 Claude 本身如何编写、脚手架搭建和调试工作流脚本。包括：

• workflow-composer：编写可运行的工作流脚本，处理文件格式、pipeline vs parallel 的判断、模式定义、确定性规则等
• toolkit-scaffold：生成构建干净的 .workflow.ts 骨架，连接到选定的 @workflow-toolbox 模式
• workflow-debugger：从运行日志诊断已完成或失败的工作流运行，分析智能体失败原因、模式重试情况、是否可安全恢复
• upgrade-canary：在 Claude Code 或 SDK 升级后重新验证 Workflow 运行时的行为是否符合工具箱依赖

可运行的工作流以单文件 .js 产物形式提交在 toolkit/workflows/ 目录下，通过 scriptPath 指向 Workflow 工具即可直接运行，无需工具链。包括完整的开发工作流族（dev-plan → dev-implement → dev-review-fix 以及串联它们的 dev-full）。

项目的核心理念是 Measured, not promised（实测而非承诺）。每一项声明都追溯到该仓库上的日志化生产运行或公开提交，包括每个智能体的 token 和工具调用计数、遗漏项统计等，可在运行机器上事后审计。

对抗性审查扫描在代码质量门（测试 + 类型检查 + 代码检查）已通过的情况下，仍发现了 22 个已验证问题。其中包括：前一个运行修复智能体写入文件的 NUL 字节、以及一个当智能体自报告提供空 SHA 时会降级为裸 git reset --hard 并静默保留错误合并的还原路径。这证明了新鲜上下文的审查者能够看到作者上下文无法看到的问题。