Workflow Cookbook

织经 · Workflow Cookbook

Claude Code 多 Agent 编排实战手册

*The Orchestration Weave — A Hands-on Guide to Multi-Agent Workflows in Claude Code*

📖 在线阅读全书 ｜ 从封面开始：中文 · English ｜ English README → README.en.md

「经之以天，纬之以地。」（《左传》）
两千年前，织工以经线为骨、纬线为肉，一梭一梭织就锦缎。经是结构，纵贯始终、不可移易；纬是功能，穿梭其间、变化万千。
今天，编排 AI Agent 也是这样。meta 与 phase 是经，是确定性的结构骨架；agent() 与 pipeline() 是纬，是在骨架中穿梭执行的智能单元。经纬交织，方成流水线。
当所有人都在手动指挥 Agent，这本书教你让它们自己编队。

这本书讲什么

动态工作流（Dynamic workflows） 是 Claude Code 的一个引擎，让你用一段 JavaScript 脚本确定性地编排多个 Agent。你在 /config 的 "Dynamic workflows" 这一行把它打开；这个开关底层对应 CLAUDE_CODE_WORKFLOWS=1 这个功能标志，power user 也可以直接设它。工具可用之后，从 v2.1.154 起你还能用 /effort ultracode 让 Claude 本会话默认主动编排。它和 MCP、Skills、Subagents、Agent Teams 都不是一回事，是一种全新的、可复用、可测试、可分享的工程流水线。

本书从零到一覆盖完整路径：先理解工作流在几种扩展机制中的位置，再掌握 agent()/parallel()/pipeline()/schema 全部 API，然后实战 7 个真实运行的配方。之后学习对抗验证、循环到干、预算、续传等进阶模式，横评四大社区系统并提取精华，构建属于自己的 Workflow 库，最终掌握从意图到上线的创作、校验与调试全流程。
这是一本实战 Cookbook，不是 API 文档。配方都以真实运行为骨：已实跑的附 Run ID 与用量，仅作示意的脚本明确标注。

本书数据一览

实测声明： 本书所有 API 描述均对照 Claude Code 官方分发包的类型定义 sdk-tools.d.ts（WorkflowInput/WorkflowOutput）逐字核对；所有标注「真实运行」的输出，均来自在真实会话中实际执行 Workflow 所得的原始结果，可在 assets/transcripts/ 逐条溯源。未实跑、仅作示意的脚本均已明确标注。

在 Claude Code 里跑通第一个 Workflow
如何运行（重要）：这是一段 Workflow 脚本，不是独立的 Node 脚本。export/meta/phase/agent/log 都是 Workflow 运行时注入的全局符号。用 node hello.js 运行会立刻报 phase is not defined（Windows / macOS 均如此）。 需要在已开启工作流的 Claude Code 会话中运行。官方入口是 /config 的 "Dynamic workflows" 这一行；在 macOS / Linux 上，power user 也可以用 CLAUDE_CODE_WORKFLOWS=1 claude 启动，Windows 或需要长期生效则写入 ~/.claude/settings.json 的 env，这种 JSON 写法跨平台。开启之后直接让 Claude 执行脚本，例如在消息中带上 ultracode 关键词（如「ultracode 跑这个 workflow」），由 Claude 调用内置的 Workflow 工具运行。
真实返回（schema 强制结构化，sum 为整数 4 而非字符串）：{"message":"…","sum":4,"runtimeConfirmed":true}（Run wf_dacbd480-d5d，1 agent / 26,338 token / 5.5s）。

目录

第一部 ·…