- 我的帖子已经打上 开源推广 标签: 是
- 我的开源项目完整开源,无未开源部分: 是
- 我的开源项目已链接认可 LINUX DO 社区: 是
- 我帖子内的项目介绍,AI生成、润色内容部分已截图发出: 是
- 以上选择我承诺是永久有效的,接受社区和佬友监督: 是
以下为项目介绍正文内容,AI生成、润色内容已使用截图方式发出
aigc已经截图,项目介绍页已附上linux do友链
「经之以天,纬之以地。」------ 《左传·昭公二十八年》两千年前,织工以经线为骨、纬线为肉,一梭一梭织就锦缎。经,是结构------纵贯始终、张紧不移;纬,是功能------穿梭其间、变化万千。
今天,编排 AI Agent 亦复如是:
meta与phase是经------确定性的结构骨架,预先张紧、不可动摇;agent()、parallel()、pipeline()是纬------在骨架中穿梭执行的智能单元。经线决定流水线的形状,纬线填入真正的工作。本书因此得名织经。
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 方便溯源。
这本书覆盖了什么?
全书共六个部分,能够让你从最初的「这是啥」到能够实现「自己写一个生产级 Workflow」:
第一部 · 认知篇 ------ Workflows 在 Claude Code 里的定位
Workflow 和 Subagents / Agent Teams / Skills / MCP 各自解决什么问题?通过相关的定位矩阵把五种机制分成编排层、认知层、连接层:
我们能通过一句话描述其边界:「先做什么 → 再做什么 → 哪些能够并行」的流程图 → 形成Workflow。
第二部 · 基础篇 ------ API 完全指南
meta、agent()、schema、parallel() vs pipeline()、phase()、budget、resume ------ 每个原语都配上了真实运行数据。
其中有个容易踩坑的地方:parallel() 和 pipeline() 的区别。前者是屏障(需要等待全部完成才返回),后者是流水线(无屏障,各 item 独立流过各 stage)。以下是其中一个案例的实测数据:
**
第三部 · 实战recipe ------ 七个真实测试过的recipe**
每个配方都配备了对应的 Run ID、agent_count、total_tokens、duration_ms,相关真实数据可以溯源。
第四部 · 进阶模式
包含了以下内容:对抗验证、循环到干与完整性批判、worktree 隔离写入、嵌套工作流、动态预算、断点续传。这部分讲的是怎么让 Workflow 的结果可信 ------ 不是进行编排然后跑出来就完事,而是需要相关过程以及最终的结果经得起质疑。
第五部 · 生态横评
这一部分拆解了四个我认为做的很优秀的workflows(ccg-workflow / superpowers / oh-my-claudecode / oh-my-openagent),看它们怎么在没有原生 Workflow 的时代是怎么做的,以及其中哪些设计可以采纳吸收用于编写属于最合适你自己的workflow。
原生 Workflow 给了确定性骨架,相关优秀的开源项目能够铸成其血肉 ------ 磁盘状态续命、Hook 注入面包屑、工具层护栏。吸纳以上这些社区工作的优秀设计特性与官方worfklows相结合能够真正生成属于你自己的workflow。
第六部 · 创作篇
从零实现一个 Workflow 的全流程:意图 → meta → 原语选择 → schema → 校验 → 真实运行 → 迭代。提供了用户可以直接 copy 的脚手架。
附录
附上相关的API完整参考,陷阱与排除,最佳实践清单,术语表,信源索引,模式目录与场景速查
虽然是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
1 个帖子 - 1 位参与者