用一个 Skill 文件,把「交付文档」也做成流水线-夜雨聆风

用一个 Skill 文件,把「交付文档」也做成流水线

我们专注于AI交付，拥有全流程工作流，让想法变成可验证、可上线的结果。

戴明（W. Edwards Deming）说：”如果你不能把你做的事描述成流程，你就并不清楚自己在做什么“。

之前我介绍过自己在搭建自己的工作流：flow-spec。

现在我升级了flow-spec，跑通了三方接口中心业务线。

在这一天里面，从需求风暴到最终测试用例结束，各个阶段的文档都落在“flow-spec/temp/”下面，会话记录进“logs/session-YYYYMMDD.md”。

这套流程能跑通的原因在于，我的主SKILL.md文件里面，写清了路线、触发词和验收方式。AI按路线出文档，我来拍板决策。

读完下面这张表，你就能知道flow-spec能帮你解决什么问题。

这篇能帮你	说明
文档从哪来、到哪去	风暴 → 任务 → 需求 → 原型 → 技术 → 开发 → 测试（Route A）
文件怎么命名	`<业务ID>_<类型>_v<版本>_<日期>.md`

核心就一句话：目录即契约，Skill 即 SOP。

换模型、换同事、只要仓库里面的规则还在，顺序就不会乱，业务产出就不会丢。

想看「结果长什么样」，打开资源管理器扫一眼 temp/ 里各文件夹即可；

一、FlowSpec 是什么？

一句话：仓库里的「交付文档生产线」——谁说哪句触发词，就走哪条技能；选哪条 Route，就产出哪一类文件。

你可以把 flow-spec 理解成一个带规则的项目骨架：目录结构、触发词、模板、验收口径都提前写在 SKILL.md 和 references/ 里。

当你说「需求风暴」「任务计划」「需求编写」「技术文档」「系统测试」这类触发词时，AI 会按既定 Route 出对应文档，不会每次重走一遍“临场发挥”。

产出默认落在 flow-spec/temp/，命名遵循 <业务ID>_<文档类型>_v<版本>_<YYYYMMDD>.md。

所以它不是一个“会聊天的提示词”，而是一套可复用、可追溯、可验收的交付工作流。

二、怎么装、怎么用？

第 1 步：把 Skill 扔进项目

把 flow-spec/ 整个目录拷进你的工程，或单独开一个知识库仓库。

没有安装器——对 AI 可见就行。

第 2 步：新开会话先喂一句

复制下面这句当开场（按你实际路径改）：

请读取并遵循 flow-spec/SKILL.md，按 Flowwork 规则执行；默认产出写在 flow-spec/temp/。

第 3 步：用触发词，别用散文

references/index.md 要不要读，交给 Agent——你要做的是 词对准：

你想干嘛	你说
风暴、澄清	「需求风暴」「需求澄清」
写 PRD	「需求编写」「PRD」
排期	「任务计划」
设计 / 实现 / 测试	「原型设计」「技术文档」「系统测试」
主路线一口气	「开始执行」（配合你已定的业务 ID）

优先级 Skill 里写死了：明确触发词 > 当前阶段 > 默认 Route A。

三、实战：我怎么走通 Route A

Route A：头脑风暴 → 任务计划 → 需求 → 原型 → 技术 → 开发 → 测试（开发若本期不做，任务里勾掉即可）。

阶段一：定业务 ID，范围别飘

我定了 THIRDAPI-CENTER，输出走默认 temp/。

人的事先拍板：接口中心管不管网关、计不计费——再让 AI 写 FT 编号，否则后面全歪。

阶段二：说一句「开始执行」

AI 按索引依次出稿，路径示例：

阶段	产出示例
风暴	`temp/brainstorm/THIRDAPI-CENTER_brainstorm_v1_20260330.md`
任务	`temp/tasks/THIRDAPI-CENTER_tasks_v1_20260330.md`
需求	`temp/requirements/THIRDAPI-CENTER_requirement_v1_20260330.md`
原型	`temp/prototypes/THIRDAPI-CENTER_prototype_v1_20260330.md`
技术	`temp/technical/THIRDAPI-CENTER_technical_v1_20260330.md`
测试	`temp/testing/THIRDAPI-CENTER_test_v1_20260330.md`

阶段三：我当监工

AI 填表快——边界和编号必须人审。

我盯三件事：

需求边界

— 有没有把「二期再说」偷偷写进一期？
追溯

— FT / BR / VR 能不能连到测试用例？
人话

— 评审的人能不能直接拆任务？

通常 2～3 轮 改到能入库。

大段 PRD、长文梳理——换你能用的最强模型。理解意图这事，模型差距是实打实的。

四、拿走即用

Skill 入口（概念路径）：flow-spec/SKILL.md

目录结构（抄作业）

flow-spec/├── SKILL.md└── references/    ├── index.md    ├── skills/    ├── templates/    ├── workflows/    └── rules/

默认落地

flow-spec/temp/├── brainstorm/├── tasks/├── requirements/├── prototypes/├── technical/├── testing/├── reverse/└── logs/

命名（别手滑）

<业务ID>_<文档类型>_v<版本>_<YYYYMMDD>.md

可选：和 OpenSpec 一起

项目若启用了 OpenSpec，Skill 里留了钩子——变更进 openspec/changes/<变更ID>/，关键节点跑 openspec validate。闸门，不是文采。

写在最后

最让我上瘾的不是某一份 PRD 写得多漂亮——而是 同一套顺序，下周还能再来一遍。

flow-spec 解决「交付物怎么从对话到仓库」。

试试看：把 flow-spec 扔进项目，新开会话，先喂规则，再说「开始执行」。