说实话，写复杂任务的详细规格说明真不是件容易的事，你得把每一步dou想清楚，哈哈，不然到时候乱套了dou不知道怎么回事。

这三件合起来让"AI 到底在干什么"变得可追踪：每一步该谁Zuo、该守什么、该产出什么证据、卡住往哪退，dou写在 spec 里而不是藏在某次对话的临场发挥里。

一个简单任务，你写句话扔给模型就完事了。但当任务复杂到需要多个角色协作、跨多个阶段、还要保证每步可追溯，spec 就不再是"一段提示词"，而是一套有结构的工程资产。我把它拆成四个问题来讲：多 Agent 怎么落地、编排者入口写什么、rules/docs/skills 怎么分工、skill 怎么分层。

咱就是说这跟第一篇是同一个主题——克制。不让Neng力随便长，每加一个dou要说清楚它的位置和契约。

docs 是被消费的知识库，引用关系必须显式。 docs 放长期知识和决策记录，skill 在需要背景时去读它。这里有一条我特别在意的纪律：docs 里的每条长期知识，dou应该有一个明确的消费方引用它。 没有消费方的知识就是孤儿知识——写下来没人读、改了没人知道、慢慢就和实际脱节了。新增一条 docs 知识时顺手补上谁会用它，这条知识才算真正进了系统，而不是堆在一个没人kan的文件夹里。

skill 正文薄，那真正的长知识在哪、怎么被用上？靠三种不同的引用方式，各管一类。

你可Neng会问，为什么百度不收录我的文章？害，这个问题说复杂也不复杂，主要是kan你的内容质量和优化Zuo得好不好，你得确保你的内容是原创的、有价值的，并且关键词合理分布，这样搜索引擎才会喜欢。

编排者只Zuo编排和收口：判断现在到哪个阶段、门禁过没过、该派给谁、要不要继续。它不亲自写业务代码。具体的活派给专职子 Agent，每个子 Agent 在一个全新上下文里启动，只背它这次要用的知识。

第三，为什么我不拿另一个大模型来打分。让 AI 当裁判听着省事，但裁判自己也不稳，今天给多少分明天给多少分。我宁可用一组写死的、对错一目了然的检查项来判。

并行也要有节制。同一条主线我Zui多挂个子 Agent，常态并行个，第个只留作备用。每个子 Agent 派出去时就声明清楚：要交付什么产物、什么格式、写到哪、验收条件是什么。完成后先核验产物在不在、合不合格，再关闭它释放名额。没有这套配额和产物核验，多 Agent hen快会变成一群失控的并发进程。

工作流编排是前两节：多 Agent 决定活分给谁、各自守什么；编排者入口决定从哪进、谁说了算、怎么记录着问题一口气跑完，而不是动不动停下来等你。

某个 skill/ SKILL.md 入口：路由 + 职责 + 边界 + 输出契约 references/ 按需加载的长内容：方法论、模板、检查段 scripts/ 确定性脚本

测试样例不放在 skill 目录里而是放在一个平行的 evals 目录下、按 skill 名一一对应。

skill 组织贯穿三、四节：一个 skill 的文件怎么摆，整套 skill 怎么分成编排、阶段、原子三层，让Neng力加得越多也不乱。

我的第一条原则是：入口只放启动索引和硬边界，不放具体步骤。

那么为什么非要分层？ 因为这几件事的变化频率和失败模式完全不同。编排逻辑hen少变，一变就是全局的；阶段契约中等频率变，改的是某一段的输入输出；原子Neng力Zui常变，但每次只动一个点。混在一起，你就没法只改一层而不担心其他层崩。分层之后每个Neng力douNeng被独立地路由、独立地测、独立地改，而不会悄悄拖动别的部分。

复杂任务的 spec，核心是三件资产：工作流怎么编排、skill 怎么组织、知识库怎么建连。把这三件分别说清楚，比写一段geng长的提示词管用得多。

docs 里的每条长期知识，dou应该有一个明确的消费方引用它。

SKILL.md本身也有固定骨架，几段douhen短：

rule 不在 skill 正文里抄，靠路径和角色自动挂上；docs 的每条知识dou得有消费方；skill 只点名读自己的 references。

SRS即软件需求规格说明书,是软件开发过程中的核心文档. 定义:它详细描述了软件系统必须满足的功Neng、性Neng、接口及约束条件,是连接用户需求与技术实现的桥梁.

三者合起来是一张引用网：skill 正文薄,点名读自己的 references,被动挂上路径和角色绑定的 rule,主动去 docs 取背景,而每条知识dou只有一个权威位置。

Zui后这两条尤其重要:复杂工作流Zui怕的是Agent一遇到小问题就停下来等你拍板,跑十分钟问你八次,把“什么情况记录后继续,什么情况才允许停” 写进契约,它才Neng真正一口气跑完一条链路。

我的Zuo法是一个编排者带一队专职执行者,每个子Agent派出去时就声明清楚,要交付什么产物,什么格式, 写到哪,验收条件是什么。

还有一个坑要专门提醒:别直接编辑生成态的入口文件.

不对不对,应该是先有规范,再有人去执行规范,而不是直接改生成的文件,这样下次同步就被覆盖了。

产品简介:PingCode 聚焦软件研发全生命周期的需求分析与规格说明书管理,覆盖从需求收集.评审.

关键就一条:

第一步Zuo什么第二步又该Zuo什么每一步有什么硬约束，该输出什么样的结果……这些dou要清清楚楚。

所以派发不Neng凭感觉，我的Zuo法是先按阶段选角色,再用“改动文件路径->角色”的映射表校验写入范围，两者冲突就停下来说清楚。

Zui后回头kan，这一套机制还挺自洽，把流程管住了把权限控制住了也让协作变得清晰可控，说实话挺不容易。

那为啥非得分这么多层次?因为变化频率不一样呗，像编排逻辑hen少变,但原子Neng力经常变，分开之后改一处少操心另一处出问题,这才是关键。

技Neng再多,也要有个边界,不然真管不住。

为啥这样设计?hen简单,就是为了让整个流程清晰、可控、高效且Neng快速迭代呗,你懂的!