「经之以天，纬之以地。」—— 《左传·昭公二十八年》
两千年前，织工以经线为骨、纬线为肉，一梭一梭织就锦缎。经，是结构——纵贯始终、张紧不移；纬，是功能——穿梭其间、变化万千。
今天，编排 AI Agent 亦复如是：meta 与 phase 是「经」——确定性的结构骨架，预先张紧、不可动摇； agent()、parallel()、pipeline() 是「纬」——在骨架中穿梭执行的智能单元。经线决定流水线的形状，纬线填入真正的工作。
本书因此得名 —— 织经。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
一、CLAUDE_CODE_WORKFLOWS 是什么
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Claude Code 新增了一个实验性特性：Workflows 。需要在 claude code v2.1.148+ 的版本中通过 ultrawork 命令调用。
Claude Code Workflows 的核心思路很简单 —— 用户通过一段纯 JavaScript 脚本，用 agent() / parallel() / pipeline() / phase() 这几个原语，确定性地编排多个 subagent 。能 git 管理、能分享、能断点续传。
这和我们以往在 claude code 中用 Subagents / Agent Teams / Skills / MCP 都不一样。之前的多 agent 方案，要么靠提示词去「请求」模型调度（模型会跳步、会忘、会跑偏），要么社区自己造轮子模拟控制流。Claude 官方的 Workflows 直接把编排逻辑从提示词里拿出来，放进了「确定性代码」。
关键问题是：这个功能在全网几乎没有详细的文档介绍。所以我专门对这个 feature 进行了深度解析，附上了相关的实战示例、最佳实践、踩坑指南。
我使用 claude code 将相关内容系统性地写出来 —— 共涵盖了 29 章 + 6 篇附录，近 15w 字的深度解析做成了专门的 cookbook ，其中每个 recipe 都在 Claude Code v2.1.150 上实际全面测试过，每个案例都附上了 Run ID 方便溯源。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
二、这本书覆盖了什么？
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
全书共六个部分，能够让你从最初的「这是啥」到能够实现「自己写一个生产级 Workflow 」：
◆ 第一部 · 认知篇 —— Workflows 在 Claude Code 里的定位
Workflow 和 Subagents / Agent Teams / Skills / MCP 各自解决什么问题？通过相关的定位矩阵把五种机制分成编排层、认知层、连接层：
· 编排层：Subagents / Workflow / Agent Teams —— 回答「谁、按什么顺序执行」
· 认知层：Skills —— 回答「 Agent 怎么想」
· 连接层：MCP —— 回答「 Agent 能够使用什么」
我们能通过一句话描述其边界：「先做什么 → 再做什么 → 哪些能够并行」的流程图 → 形成 Workflow 。
◆ 第二部 · 基础篇 —— API 完全指南
meta 、agent()、schema 、parallel() vs pipeline()、phase()、budget 、resume —— 每个参数都配上了真实运行数据。
其中有个容易踩坑的地方：parallel() 和 pipeline() 的区别。前者是「屏障」（需要等待全部完成才返回），后者是「流水线」（无屏障，各 item 独立流过各 stage ）。以下是其中一个案例的实测数据：
· parallel 3 并发：Run wf_52957913-6d2 ，3 agents ，78,844 tokens ，墙钟 8.4s
· pipeline 3×2 阶段：Run wf_bf086b98-6ec ，6 agents ，158,982 tokens ，墙钟 26.7s
编排本身零 token （ Run wf_59bf3654-183：0 token / 4ms ）—— 成本全在 agent() 节点上。
◆ 第三部 · 实战 recipe —— 七个真实测试过的 recipe
· 分片代码审查：Scan → Review → Verify → Synthesize ，pipeline 逐片流过
· PR 多维 Review：多维度 pipeline + 对抗验证，26 条 → 16 条（干掉 10 条误报）
· 生成-批评-修复：生成 → 批评 → 修复循环，揪出 10 个缺陷（ 2 CRITICAL ）
· 深度研究：多角度检索 + 交叉核实，抓到一条死链（ HTTP 410 ）
· 评委面板：3 个独立评委打分，3:0 一致
· Bug 猎手：猎手找 bug → 独立证伪者逐条验证，5/5 全部命中
· 大扫除：批量扫描 + 逐文件改写，report-only 先看再改
每个配方都配备了对应的 Run ID 、agent_count 、total_tokens 、duration_ms ，相关真实数据可以溯源。
◆ 第四部 · 进阶模式
包含了以下内容：对抗验证、循环到干与完整性批判、worktree 隔离写入、嵌套工作流、动态预算、断点续传。
这部分讲的是怎么让 Workflow 的「结果可信」—— 不是进行编排然后跑出来就完事，而是需要相关过程以及最终的结果经得起质疑。
◆ 第五部 · 生态横评
这一部分拆解了四个我认为做得很优秀的 workflows （ ccg-workflow / superpowers / oh-my-claudecode / oh-my-openagent ），看它们怎么在没有原生 Workflow 的时代是怎么做的，以及其中哪些设计可以采纳吸收，用于编写属于最合适你自己的 workflow 。
原生 Workflow 给了确定性骨架，相关优秀的开源项目能够铸成其血肉 —— 磁盘状态续命、Hook 注入面包屑、工具层护栏。吸纳以上这些社区工作的优秀设计特性与官方 workflows 相结合，能够真正生成属于你自己的 workflow 。
◆ 第六部 · 创作篇
从零实现一个 Workflow 的全流程：意图 → meta → 原语选择 → schema → 校验 → 真实运行 → 迭代。提供了用户可以直接 copy 的脚手架。
◆ 附录
附上相关的 API 完整参考、陷阱与排除、最佳实践清单、术语表、信源索引、模式目录与场景速查。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
书里所有技术论断分三级：
· 官方：来自 Claude Code 的 sdk-tools.d.ts 类型定义
· 实测：本机跑出来的，带 Run ID
· 第三方：社区资料，对其内容进行了「核实」
全书 23 个测试对应的 Run ID ，其原始运行记录保存在 assets/transcripts/，使得该 cookbook 中的内容均可溯源。
全书耗费两天时间进行认真的编写，将近 15w 字，对 Claude Code Workflows 该官方特性进行深度解读。从官方的 workflows 学习其真实实现，吸纳其精华。
直接点击下方链接进行观看 👇 觉得有用的去 github 点个 star 就是最大的支持。如果有任何问题，欢迎提 issues 和 pr 。
在线阅读： https://agi-is-going-to-arrive.github.io/workflow-cookbook/
GitHub： https://github.com/AGI-is-going-to-arrive/workflow-cookbook
两千年前，织工以经线为骨、纬线为肉，一梭一梭织就锦缎。经，是结构——纵贯始终、张紧不移；纬，是功能——穿梭其间、变化万千。
今天，编排 AI Agent 亦复如是：meta 与 phase 是「经」——确定性的结构骨架，预先张紧、不可动摇； agent()、parallel()、pipeline() 是「纬」——在骨架中穿梭执行的智能单元。经线决定流水线的形状，纬线填入真正的工作。
本书因此得名 —— 织经。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
一、CLAUDE_CODE_WORKFLOWS 是什么
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Claude Code 新增了一个实验性特性：Workflows 。需要在 claude code v2.1.148+ 的版本中通过 ultrawork 命令调用。
Claude Code Workflows 的核心思路很简单 —— 用户通过一段纯 JavaScript 脚本，用 agent() / parallel() / pipeline() / phase() 这几个原语，确定性地编排多个 subagent 。能 git 管理、能分享、能断点续传。
这和我们以往在 claude code 中用 Subagents / Agent Teams / Skills / MCP 都不一样。之前的多 agent 方案，要么靠提示词去「请求」模型调度（模型会跳步、会忘、会跑偏），要么社区自己造轮子模拟控制流。Claude 官方的 Workflows 直接把编排逻辑从提示词里拿出来，放进了「确定性代码」。
关键问题是：这个功能在全网几乎没有详细的文档介绍。所以我专门对这个 feature 进行了深度解析，附上了相关的实战示例、最佳实践、踩坑指南。
我使用 claude code 将相关内容系统性地写出来 —— 共涵盖了 29 章 + 6 篇附录，近 15w 字的深度解析做成了专门的 cookbook ，其中每个 recipe 都在 Claude Code v2.1.150 上实际全面测试过，每个案例都附上了 Run ID 方便溯源。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
二、这本书覆盖了什么？
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
全书共六个部分，能够让你从最初的「这是啥」到能够实现「自己写一个生产级 Workflow 」：
◆ 第一部 · 认知篇 —— Workflows 在 Claude Code 里的定位
Workflow 和 Subagents / Agent Teams / Skills / MCP 各自解决什么问题？通过相关的定位矩阵把五种机制分成编排层、认知层、连接层：
· 编排层：Subagents / Workflow / Agent Teams —— 回答「谁、按什么顺序执行」
· 认知层：Skills —— 回答「 Agent 怎么想」
· 连接层：MCP —— 回答「 Agent 能够使用什么」
我们能通过一句话描述其边界：「先做什么 → 再做什么 → 哪些能够并行」的流程图 → 形成 Workflow 。
◆ 第二部 · 基础篇 —— API 完全指南
meta 、agent()、schema 、parallel() vs pipeline()、phase()、budget 、resume —— 每个参数都配上了真实运行数据。
其中有个容易踩坑的地方：parallel() 和 pipeline() 的区别。前者是「屏障」（需要等待全部完成才返回），后者是「流水线」（无屏障，各 item 独立流过各 stage ）。以下是其中一个案例的实测数据：
· parallel 3 并发：Run wf_52957913-6d2 ，3 agents ，78,844 tokens ，墙钟 8.4s
· pipeline 3×2 阶段：Run wf_bf086b98-6ec ，6 agents ，158,982 tokens ，墙钟 26.7s
编排本身零 token （ Run wf_59bf3654-183：0 token / 4ms ）—— 成本全在 agent() 节点上。
◆ 第三部 · 实战 recipe —— 七个真实测试过的 recipe
· 分片代码审查：Scan → Review → Verify → Synthesize ，pipeline 逐片流过
· PR 多维 Review：多维度 pipeline + 对抗验证，26 条 → 16 条（干掉 10 条误报）
· 生成-批评-修复：生成 → 批评 → 修复循环，揪出 10 个缺陷（ 2 CRITICAL ）
· 深度研究：多角度检索 + 交叉核实，抓到一条死链（ HTTP 410 ）
· 评委面板：3 个独立评委打分，3:0 一致
· Bug 猎手：猎手找 bug → 独立证伪者逐条验证，5/5 全部命中
· 大扫除：批量扫描 + 逐文件改写，report-only 先看再改
每个配方都配备了对应的 Run ID 、agent_count 、total_tokens 、duration_ms ，相关真实数据可以溯源。
◆ 第四部 · 进阶模式
包含了以下内容：对抗验证、循环到干与完整性批判、worktree 隔离写入、嵌套工作流、动态预算、断点续传。
这部分讲的是怎么让 Workflow 的「结果可信」—— 不是进行编排然后跑出来就完事，而是需要相关过程以及最终的结果经得起质疑。
◆ 第五部 · 生态横评
这一部分拆解了四个我认为做得很优秀的 workflows （ ccg-workflow / superpowers / oh-my-claudecode / oh-my-openagent ），看它们怎么在没有原生 Workflow 的时代是怎么做的，以及其中哪些设计可以采纳吸收，用于编写属于最合适你自己的 workflow 。
原生 Workflow 给了确定性骨架，相关优秀的开源项目能够铸成其血肉 —— 磁盘状态续命、Hook 注入面包屑、工具层护栏。吸纳以上这些社区工作的优秀设计特性与官方 workflows 相结合，能够真正生成属于你自己的 workflow 。
◆ 第六部 · 创作篇
从零实现一个 Workflow 的全流程：意图 → meta → 原语选择 → schema → 校验 → 真实运行 → 迭代。提供了用户可以直接 copy 的脚手架。
◆ 附录
附上相关的 API 完整参考、陷阱与排除、最佳实践清单、术语表、信源索引、模式目录与场景速查。
━━━━━━━━━━━━━━━━━━━━━━━━━━━━
书里所有技术论断分三级：
· 官方：来自 Claude Code 的 sdk-tools.d.ts 类型定义
· 实测：本机跑出来的，带 Run ID
· 第三方：社区资料，对其内容进行了「核实」
全书 23 个测试对应的 Run ID ，其原始运行记录保存在 assets/transcripts/，使得该 cookbook 中的内容均可溯源。
全书耗费两天时间进行认真的编写，将近 15w 字，对 Claude Code Workflows 该官方特性进行深度解读。从官方的 workflows 学习其真实实现，吸纳其精华。
直接点击下方链接进行观看 👇 觉得有用的去 github 点个 star 就是最大的支持。如果有任何问题，欢迎提 issues 和 pr 。
在线阅读： https://agi-is-going-to-arrive.github.io/workflow-cookbook/
GitHub： https://github.com/AGI-is-going-to-arrive/workflow-cookbook
Select Language