用途:workflow-creator 用于端到端管理 Claude Code 工作流,编排位于 .claude/workflows/ 的多智能体脚本。它交付两件事:一是 .claude/workflows/<name>.js(项目)或 ~/.claude/workflows/(个人)中的可运行 JavaScript 编排文件;二是运行产生的执行记录,包括账本、实时进度、恢复键和恢复路径。
主要能力:工作流本体是确定性代码,循环、条件和扇出均为普通 JavaScript,只有叶节点 agent() 调用消耗 token,各自拥有独立上下文窗口。提供 API、编排模式、并发经济性、恢复与外部通道等参考;内置扇出、循环、流水线、运行账本模板;附带 API 契约漂移检测、代码通道批处理、死代码清扫、实现与审查、编排工作器、规划卡分类、重建与对账、审查分支、路由与重构等示例,以及校验与零 token 干跑脚本。
使用方式:先用 Workflow({ name }) 或 Workflow({ scriptPath }) 启动,运行转入后台并立即返回运行 ID,完成时通知,可用 /workflows 实时查看。启动后应立即把运行 ID、scriptPath、args 和准确的恢复命令写入运行账本。修改保存的文件并恢复运行即可迭代,首次编辑前的 agent() 调用从缓存重放。保存成功的运行可在 /workflows 中按 s,使其成为 /<name> 命令。
适用场景:任务可并行或多阶段、编排需要确定且可恢复、每步独立上下文有价值时。限制:单智能体任务不值得使用;伪装成可分解的依赖链会引入开销。工作流体必须用普通 JavaScript,不得使用 TypeScript;禁止 Date.now()、Math.random() 和无参 new Date();编排器不持有文件系统或 Node API;parallel() 接收 thunk 而非 Promise;每个开放式循环必须有硬性停止条件;每个工作流在消耗 token 前都需通过校验和干跑两关卡。