织经：Claude Code 官方 Workflows 深度剖析实战手册

「经之以天，纬之以地。」—— 《左传·昭公二十八年》
两千年前，织工以经线为骨、纬线为肉，一梭一梭织就锦缎。
经，是结构——纵贯始终、张紧不移；纬，是功能——穿梭其间、变化万千。

今天，编排 AI Agent 亦复如是：
meta 与 phase 是经——确定性的结构骨架，预先张紧、不可动摇；
agent()、parallel()、pipeline() 是纬——在骨架中穿梭执行的智能单元。
经线决定流水线的形状，纬线填入真正的工作。

本书因此得名织经。

1. CLAUDE_CODE_WORKFLOWS 是什么

Claude Code 新增了一个实验性特性：Workflows。
需要在 claude code v2.1.148+ 的版本中通过 ultrawork 命令调用。
v2.1.153 版本已更新为直接使用 workflows 这个命令进行触发。

Claude Code Workflows 的核心思路很简单

用户通过一段纯 JavaScript 脚本，用 agent() / parallel() / pipeline() / phase() 这几个原语，来确定性地编排多个 subagent。
具有实现 git 管理、分享、断点续传等能力。

这和我们以往在 claude code 中用 Subagents / Agent Teams / Skills / MCP 都不一样。
之前的多 agent 方案，

要么靠提示词去「请求」模型调度（模型会跳步、会忘、会跑偏），要么社区自己造轮子模拟控制流。
Claude 官方的 Workflows 直接把编排逻辑从提示词中跳出来，使用确定性代码来实现。

我在探索这个 feature 时遇到了一个关键问题：

这个功能在全网几乎没有详细的文档介绍。
所以我专门对于这个 feature 进行了深度解析，附上了相关的实战示例、最佳实践、踩坑指南。

我使用 claude code 将相关内容系统性地写出来

共涵盖了 29 章 + 6 篇附录，近 15w 字的深度解析，做成了专门的 cookbook，
其中每个 recipe 都在 Claude Code v2.1.150 上实际全面测试过，
每个案例都附上了 Run ID 方便溯源。

2. 这本书覆盖了什么？

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

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

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

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

2.2 第二部 · 基础篇 —— API 完全指南

meta、agent()、schema、parallel() vs pipeline()、phase()、budget、resume——
每个原语都配上了真实运行数据。

其中有个容易踩坑的地方：parallel() 和 pipeline() 的区别。
前者是屏障（需要等待全部完成才返回），后者是流水线（无屏障，各 item 独立流过各 stage）。
以下是其中一个案例的实测数据：

2.3 第三部 · 实战 recipe —— 七个真实测试过的 recipe

每个配方都配备了对应的 Run ID、agent_count、total_tokens、duration_ms，相关真实数据可以溯源。

2.4 第四部 · 进阶模式

包含了以下内容：对抗验证、循环收敛与完整性审查、worktree 隔离写入、嵌套工作流、动态预算、断点续传。
这部分讲的是怎么让 Workflow 的结果可信——

不是进行编排然后跑出来就完事，而是需要相关过程以及最终的结果经得起质疑。

2.5 第五部 · 生态横评

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

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

2.6 第六部 · 创作篇

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

2.7 附录

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

3. 结论

虽然是 vibe coding 出来的，但是对于所有相关信源，进行了九轮的全量验证，欢迎捉虫。

书里所有技术总结分三级：

• 官方（来自 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