software-factory skill 如何用五個詞釐清自動化流水線設計
自动化流水线设计不出来?先把五个词钉死,问题会自己浮出来
mattpocock/skills 的 software-factory skill 以 task、run、trigger、service、brake 五個詞統一自動化流水線討論,並用明確條件檢查設計是否完整。它不執行程式碼,而是禁用含混同義詞,並要求每個 trigger 配上自動檢查、自動評審或人工評審等制動措施。每個 task 和工單來源都要回答五個問題,未填妥的項目代表設計仍有缺漏。
2026-11-21 6
版权
版权声明:
本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《 阿里云开发者社区用户服务协议》和 《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写 侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
简介: mattpocock/skills 里有个 software-factory skill,922 个词,不跑任何代码。它只做一件事:把 task、run、trigger、service、brake 这五个词的定义钉死,并禁用一批同义词。听起来很虚,但它附带的「设计完成的判定条件」和「加速器必须有刹车」这两条,能让设计评审里的空话当场现形。
你可能遇到过这个场景
拉三个人聊「自动化流水线怎么设计」,半小时后你会发现:
- 有人说 job,有人说 workflow,有人说 task,指的都差不多;
- 讨论了三轮「这个触发器怎么配」,其实每轮说的是不同的东西;
- 最后写下来的方案,每个人理解都不一样。
问题不是没人懂技术,是名词没统一。
mattpocock/skills 这个仓库(328,182 星)里有个 skill 专门治这个。它有 922 个词,一行代码都不跑。
它到底做什么
不执行、不生成、不检查代码。它改变的是你和 AI 讨论这事的用词。
SKILL.md 的规则很直接:翻译过来是「讨论或画白板时只用这些词;当用户用了 Avoid 里的词,把标准词说出来」。
也就是说,AI 会纠正你的用词。
五个词,各带一个禁用清单
| 词 | 在这套体系里的意思 | 禁用 |
|---|---|---|
| task | 流水线重复执行的工作单元 | job、pipeline step |
| run | 一个 task 的一次执行 | invocation、job |
| trigger | 什么启动一次 run(工单、定时、webhook) | — |
| service | 流水线接入的外部产品 | integration、tool |
| brake | 自动检查、评审或人工闸门 | — |
注意 run 的禁用词里有 job,task 的禁用词里也有 job。一个词被两个概念同时禁掉——这不是遗漏,是故意的:job 这个词太含混,直接不用。
三条规矩里,第二条最有价值
skill 让 AI 做四件事,前两条是常规的(用标准词、从用户的问题出发)。第三条是重点:
「每个 trigger 都是加速器。没有刹车的加速器只会制造垃圾。」
然后给出三种被允许的刹车:自动检查、自动评审、人工评审。
这句话戳中的是很常见的失败:团队花三个月把「提交代码就自动跑测试、自动部署、自动生成 changelog」串起来,结果没人管质量,只把错误更快地推到生产。
加速很容易做,刹车需要设计。
落地节奏:一次只加一个
它给的建议具体到数字:
「一次只加一个自动触发,一开始限流(十份 bug 报告处理一份、定时任务一天一次),并且每个 PR 都要人工评审。」
这条比「逐步推进」那种空话有用,因为它给了可执行的初始参数。
什么算「设计完成」
这是整套东西里最有牙齿的一条:
设计完成的判定是:每个槽位都写明了具体产品(可观测性平台可以是明确的「无」),并且每个 task 和每个工单来源,对每个问题都有答案。
配套是一张五问清单,每个 task 都要回答:
- 什么触发它
- 它读什么、写什么
- 下一步是谁
- 人在哪里重新介入
- 怎么防止重复执行(重复触发怎么办)
这是一张会当场失败的检查表。 你说「设计完了」,把这张表填一遍,空着的地方就是没想清楚的地方。
大多数「设计 skill」只给框架,不给你一个能判空的表。
知识在别处:五个参考文件
SKILL.md 本身一个 URL 都没有。真正的料在五个同级文件里,约 6,377 词:
| 文件 | 词数 | 内容 |
|---|---|---|
EXAMPLE-TASKS.md |
690 | 11 个「问题 → task」场景 |
TICKET_TRACKERS.md |
1,221 | 17 个厂商文档链接 |
GIT_HOSTS.md |
1,110 | 14 个链接 |
RUNNERS.md |
1,288 | 11 个链接 |
OBSERVABILITY_PLATFORMS.md |
1,122 | 7 个链接 |
跨四个文件共 71 个外部链接,全是文档和定价页——GitHub Actions、Linear、E2B、Daytona、Modal、Fly.io、Langfuse、Datadog、Grafana、Honeycomb、OpenTelemetry。
这些是选型清单,不是自动调用。skill 从不替你请求这些地址,它只是把「你本来要搜半天的东西」列出来。
为什么它不能自动触发
frontmatter 里有 disable-model-invocation: true。
意思是:模型不能自己决定用它,必须人主动敲。
这个设计是对的。一个要重写你讨论用词的 skill,如果自动触发,会在所有普通的技术讨论里插一脚。
代价是:你得记得用它。 没有钩子、没有会话注入、没有工具调用,只有一次文件读取。
一个安装上的坑
这个 skill 在 in-progress/ 目录里,而仓库插件的 skills 数组列了 27 项,不含它。
仓库自己的 CLAUDE.md 写明了政策:in-progress 是「故意公开、想要反馈、但不随插件发布」。
| 安装方式 | 能不能拿到 |
|---|---|
| 插件安装 | 不能 |
npx skills@latest add mattpocock/skills |
能(拷贝可编辑文件) |
| Codex marketplace | 能 |
所以从插件装完发现没有这个 skill,不是你装错了。
它在 skills.pub 上的页面:https://skills.pub/en/skills/mattpocock-skills-software-factory
什么时候值得用
如果你正要设计一条自动化流水线,而且不止一个人参与,光那张禁用词表就值一次会。
如果你一个人干、用词本来就一致,它给你一份选型清单,别的帮助不大——作者自己也把这个标成 beta,在收反馈。
用之前检查三件事
- 用
npx skills add装,不要用插件,然后确认项目里有software-factory/SKILL.md。 - 聊流水线时故意说「job」,如果 skill 生效了,AI 应该把它纠正成
task或run。 - 让它收尾一个有空的槽位的设计,它应该拒绝,而不是编一个产品填上。
小结
| 你遇到的问题 | 这个 skill 的解法 |
|---|---|
| 讨论半天各说各话 | 钉死五个词,禁掉含混的同义词 |
| 自动化上线后质量崩 | 加速器必须配刹车,三种刹车可选 |
| 一上来全自动 | 一次一个触发,带限流和人工评审 |
| 不知道怎么算设计完了 | 五问清单,空着就是没想清楚 |
| 选型靠瞎搜 | 71 个厂商文档链接,按类分好 |
值得抄的不是这五个词本身,是「先统一名词,再谈方案」这个顺序。词不统一的时候,方案评审会一直在翻译。
原文(英文):https://skills.pub/en/blog/mattpocock-skills-software-factory-explained
这个 skill 在 skills.pub 上的页面:https://skills.pub/en/skills/mattpocock-skills-software-factory
來源:阿里雲開發者社區 AI · developer.aliyun.com