让 AI 写代码前先问清楚:Matt Pocock 的 skills 安装和使用教程

271次阅读
没有评论

共计 2804 个字符,预计需要花费 8 分钟才能阅读完成。

你有没有过这种经历:跟 AI 说「帮我加个登录功能」,它哗啦啦写了几百行,跑起来才发现根本不是你要的。AI 倒也不笨,问题是你俩没对齐。你脑子里的「登录」和它理解的「登录」压根不是一回事。

这两天 GitHub 热榜上有个仓库特别显眼:TypeScript 圈里很有名的老师 Matt Pocock,把自己每天用的一套「AI 工作规矩」开源了,叫 skills。我今天下午查的时候是 31 万多颗星,当天还在涨两千多。

它其实就是一本给 AI 新同事的员工手册。你把手册放进项目里,AI 在动手之前就知道:先问清楚、先写测试、出 bug 先找能复现的办法,别闷头瞎写。

对普通人有什么用?如果你用 Cursor、Claude Code、Codex 这类工具让 AI 帮你写点小脚本、小网站,装上它以后,AI 会先追着你问几个问题,再动手。返工少了,你也不用对着几百行看不懂的代码发呆。

这本「员工手册」里都有啥

仓库里分了几个文件夹,每个文件夹下面是一条条「规矩」,每条规矩就是一个文件夹,核心是一个叫 SKILL.md 的说明文件。AI 读到它,就照着做。

我挑了对新手最有用的四条:

规矩名字一句话说明什么时候用
grill-me让 AI 先「拷问」你,把需求问清楚每次准备让 AI 动手之前
tdd先写一个会失败的测试,再写代码让它通过让 AI 写新功能、修 bug
diagnosing-bugs修 bug 先搭一个能稳定复现的办法程序报错、变慢、时好时坏
setup-matt-pocock-skills第一次用时的初始化问答每个项目跑一次
让 AI 写代码前先问清楚:Matt Pocock 的 skills 安装和使用教程
新手先装这四条就够用

作者自己最推荐的是 grill-me。他在说明里讲得很直白:软件开发最常见的失败,就是你以为对方懂了,其实没懂。人和人之间这样,人和 AI 之间也一样。

安装:一条命令搞定

我是在自己的 Linux 电脑上装的(Windows、Mac 一样,只要装了 Node.js)。先新建一个空文件夹当项目,进去以后运行:

npx skills@latest add mattpocock/skills --agent cursor --skill grill-me grilling tdd setup-matt-pocock-skills -y

几个参数解释一下:

  • --agent cursor:告诉它你用的是哪个 AI 工具。用别的就换成对应名字,比如 opencode、windsurf;不写这一项,它会弹出菜单让你选。
  • --skill:只装你点名的几条。不写的话会让你从一长串里勾选。
  • -y:一路默认确认,省得一个个按回车。

如果你用的是 Claude Code 或 Codex,官方还给了插件装法,会自动更新:

# Claude Code
claude plugin install mattpocock-skills@claude-plugins-official
# Codex
codex plugin marketplace add mattpocock/skills
codex plugin add mattpocock-skills@mattpocock

我这台机器上没装 Claude Code,所以走的是第一种 npx 的办法。装完它会把文件复制到项目里的 .agents/skills/ 下面,顺手还显示了一张安全检查表,几家扫描结果都是「安全 / 低风险」。

让 AI 写代码前先问清楚:Matt Pocock 的 skills 安装和使用教程
第一次安装:四条规矩复制到 .agents/skills,附安全检查表(2026-11-06 下午实测,北京时间)

想看装了哪些,运行:

npx skills@latest list
让 AI 写代码前先问清楚:Matt Pocock 的 skills 安装和使用教程
list 查看当前项目装了哪些(2026-11-06 下午实测,北京时间)

我踩的一个坑:grill-me 其实是个「空壳」

装完我好奇点开 grill-me 的 SKILL.md,结果里面就一句话:「去调用 grilling 这个技能」。

也就是说,grill-me 只是个快捷入口,真正干活的是 grilling。如果你只装了 grill-me,AI 找不到 grilling,这条规矩就等于白装。

解决办法:装的时候把 grilling 一起带上(上面那条命令我已经加进去了)。如果你已经装过了,补一条就行:

npx skills@latest add mattpocock/skills --agent cursor --skill grilling -y
让 AI 写代码前先问清楚:Matt Pocock 的 skills 安装和使用教程
grill-me 里只有一句话,真正干活的是 grilling,补装即可(2026-11-06 下午实测,北京时间)

怎么用:在 AI 对话框里打斜杠命令

装好以后,打开 Cursor(或你用的工具),在这个项目里跟 AI 对话:

第一步,初始化。 输入 /setup-matt-pocock-skills。它会问你三件事:任务记在哪(GitHub、GitLab 还是本地文件)、你平时给任务打什么标签、生成的文档存哪。照实回答就行,不懂就选「本地文件」。

第二步,让它拷问你。 比如你想做一个记账小网页,别直接说「帮我写」,先输入:

/grill-me 我想做一个记账网页,能记每天花了多少钱

按 grilling 里写的规矩,AI 会一轮一轮地提问,每个问题后面附上它推荐的答案,你只要回「是」就是接受推荐。比如它可能会问:数据存在浏览器里还是存服务器上?要不要分类?要不要按月统计?问到没有悬而未决的问题为止,而且在你点头确认之前,它不会动手写代码。

让 AI 写代码前先问清楚:Matt Pocock 的 skills 安装和使用教程
grilling 的提问方式:每题附推荐答案,回「是」即接受

第三步,让它按测试来写。 需求对齐以后,输入 /tdd 按刚才说好的做第一个功能。它会先跟你确认「从哪测」,再写一个会失败的测试,然后补代码让测试通过,一小块一小块往前推。好处是每一步都有个「过没过」的信号,不会一口气写一大坨再说。

出 bug 时,用 /diagnosing-bugs。它的第一步不是猜原因,而是先想办法让 bug 稳定出现。能稳定复现,就好找了。顺带一提,这条规矩里还特意要求 AI 把密码、密钥这类东西打码再展示,挺贴心。

让 AI 写代码前先问清楚:Matt Pocock 的 skills 安装和使用教程
diagnosing-bugs 的思路:先复现,再找原因

不想要了怎么删

npx skills@latest remove diagnosing-bugs -y

我试了一下,删得很干净,对应文件夹直接没了。全部更新用 npx skills@latest update。

几个小提醒

  • 它不是软件,是一堆说明文字。 你得有个会读这些说明的 AI 工具(Cursor、Claude Code、Codex、Copilot、Gemini CLI 等)才能发挥作用。
  • 原文是英文。 AI 读得懂,你直接用中文跟 AI 聊就行,它会用中文问你。
  • 别一次全装。 仓库里有二三十条,一次装满反而容易互相打架。先从 grill-me + grilling 开始,用顺手了再加 tdd。
  • 安装提示里那句话是真的:这些规矩会以 AI 的全部权限运行,装别人的 skills 之前,最好点开 SKILL.md 扫一眼。

我自己的感受:这套东西没让 AI 变聪明多少,它干的事是让 AI 先慢下来。多问五个问题,比事后返工五次划算多了。

项目地址:github.com/mattpocock/skills(MIT 开源)

正文完
 0

版权声明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。

科技喵仔
版权声明:本站原创文章,由 科技喵仔 于2026-11-06发表,共计2804字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
评论(没有评论)
验证码
    中文English