[开源] 《织经》—— Claude Code Workflows 深度剖析， 29 章实战手册

「经之以天，纬之以地。」—— 《左传·昭公二十八年》

两千年前，织工以经线为骨、纬线为肉，一梭一梭织就锦缎。经，是结构——纵贯始终、张紧不移；纬，是功能——穿梭其间、变化万千。

今天，编排 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 方便溯源。

https://i.imgur.com/8zaFDGW.png

这本书覆盖了什么？

全书共六个部分，能够让你从最初的「这是啥」到能够实现「自己写一个生产级 Workflow 」：

第一部 · 认知篇 —— Workflows 在 Claude Code 里的定位

Workflow 和 Subagents / Agent Teams / Skills / MCP 各自解决什么问题？通过相关的定位矩阵把五种机制分成编排层、认知层、连接层：

• 编排层：Subagents / Workflow / Agent Teams —— 回答「谁、按什么顺序执行」
• 认知层：Skills —— 回答「 Agent 怎么想」
• 连接层：MCP —— 回答「 Agent 能够使用什么」

我们能通过一句话描述其边界：「先做什么 → 再做什么 → 哪些能够并行」的流程图 → 形成 Workflow 。

https://i.imgur.com/eT9PK16.png

第二部 · 基础篇 —— 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() 节点上。

https://i.imgur.com/av09fEe.png

第三部 · 实战 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 ，相关真实数据可以溯源。

https://i.imgur.com/XSS8dHu.png

第四部 · 进阶模式

包含了以下内容：对抗验证、循环到干与完整性批判、worktree 隔离写入、嵌套工作流、动态预算、断点续传。

这部分讲的是怎么让 Workflow 的结果可信 —— 不是进行编排然后跑出来就完事，而是需要相关过程以及最终的结果经得起质疑。

https://i.imgur.com/YQED5A5.png

第五部 · 生态横评

这一部分拆解了四个我认为做得很优秀的 workflows （ ccg-workflow / superpowers / oh-my-claudecode / oh-my-openagent ），看它们怎么在没有原生 Workflow 的时代是怎么做的，以及其中哪些设计可以采纳吸收，用于编写属于最合适你自己的 workflow 。

原生 Workflow 给了确定性骨架，相关优秀的开源项目能够铸成其血肉 —— 磁盘状态续命、Hook 注入面包屑、工具层护栏。吸纳以上这些社区工作的优秀设计特性与官方 workflows 相结合，能够真正生成属于你自己的 workflow 。

https://i.imgur.com/gteKkLn.png

第六部 · 创作篇

从零实现一个 Workflow 的全流程：意图 → meta → 原语选择 → schema → 校验 → 真实运行 → 迭代。提供了用户可以直接 copy 的脚手架。

https://i.imgur.com/GRnsA36.png

附录

附上相关的 API 完整参考、陷阱与排除、最佳实践清单、术语表、信源索引、模式目录与场景速查。

https://i.imgur.com/shPHqd0.png

书里所有技术论断分三级：官方（来自 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