「开源」《织经》—— 对于Claude Code 官方Workflows 深度剖析,15w字实战手册

本帖使用社区开源推广,符合推广要求。我申明并遵循社区要求的以下内容: 我的帖子已经打上 开源推广 标签: 是 我的开源项目完整开源,无未开源部分: 是 我的开源项目已链接认可 LINUX DO 社区: 是 我帖子内的项目介绍,AI生成、润色内容部分已截图发出: 是 以上选择我承诺是永久有效的,接受社...
「开源」《织经》—— 对于Claude Code 官方Workflows 深度剖析,15w字实战手册
开源」《织经》—— 对于Claude Code 官方Workflows 深度剖析,15w字实战手册
本帖使用社区开源推广,符合推广要求。我申明并遵循社区要求的以下内容:
  • 我的帖子已经打上 开源推广 标签:
  • 我的开源项目完整开源,无未开源部分:
  • 我的开源项目已链接认可 LINUX DO 社区:
  • 我帖子内的项目介绍,AI生成、润色内容部分已截图发出:
  • 以上选择我承诺是永久有效的,接受社区和佬友监督:

以下为项目介绍正文内容,AI生成、润色内容已使用截图方式发出
aigc已经截图,项目介绍页已附上linux do友链


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

今天,编排 AI Agent 亦复如是:metaphase------确定性的结构骨架,预先张紧、不可动摇;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 方便溯源。

CleanShot 2026-05-28 at 12.20.57@2x

这本书覆盖了什么?

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

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

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

CleanShot 2026-05-28 at 12.21.08@2x

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

CleanShot 2026-05-28 at 12.21.39@2x

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

metaagent()schemaparallel() vs pipeline()phase()budgetresume ------ 每个原语都配上了真实运行数据。

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

CleanShot 2026-05-28 at 12.22.15@2x

CleanShot 2026-05-28 at 12.22.33@2x

**

第三部 · 实战recipe ------ 七个真实测试过的recipe**

CleanShot 2026-05-28 at 12.23.13@2x

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

CleanShot 2026-05-28 at 12.23.29@2x

第四部 · 进阶模式

包含了以下内容:对抗验证、循环到干与完整性批判、worktree 隔离写入、嵌套工作流、动态预算、断点续传。这部分讲的是怎么让 Workflow 的结果可信 ------ 不是进行编排然后跑出来就完事,而是需要相关过程以及最终的结果经得起质疑。

CleanShot 2026-05-28 at 12.23.42@2x

第五部 · 生态横评

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

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

CleanShot 2026-05-28 at 12.23.56@2x

第六部 · 创作篇

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

CleanShot 2026-05-28 at 12.24.09@2x

附录

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

CleanShot 2026-05-28 at 12.24.20@2x

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

书里所有技术总结分三级:官方(来自 Claude Code 的 sdk-tools.d.ts 类型定义)、实测(本机跑出来的,带 Run ID)、第三方(社区资料,对于其内容进行了「核实」)。全书 23 个测试对应的 Run ID,其原始运行记录保存在 assets/transcripts/使得该cookbook中的内容均可溯源。

全书耗费两天时间进行认真的编写,将近15w字,对于Claude Code Workflows 该官方特性进行深度解读。
从官方的workflows学习其真实实现,吸纳其精华。

直接点击下方链接进行观看:backhand_index_pointing_down:,觉得有用的去github 点个star​: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 位参与者

阅读完整话题

来源: LinuxDo 最新话题查看原文