跳到正文
阿里雲開發者社區 AI·· 21 小時前AI 評分57

software-factory skill 如何用五個詞釐清自動化流水線設計

自动化流水线设计不出来?先把五个词钉死,问题会自己浮出来

AI 導讀

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 都要回答:

  1. 什么触发它
  2. 它读什么、写什么
  3. 下一步是谁
  4. 人在哪里重新介入
  5. 怎么防止重复执行(重复触发怎么办)

这是一张会当场失败的检查表。 你说「设计完了」,把这张表填一遍,空着的地方就是没想清楚的地方。

大多数「设计 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,在收反馈。

用之前检查三件事

  1. 用 npx skills add 装,不要用插件,然后确认项目里有 software-factory/SKILL.md。
  2. 聊流水线时故意说「job」,如果 skill 生效了,AI 应该把它纠正成 task 或 run。
  3. 让它收尾一个有空的槽位的设计,它应该拒绝,而不是编一个产品填上。

小结

你遇到的问题 这个 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