Skills:给 AI Agent 配一套工程工作流
Skills For Real Engineers 在 GitHub 上已经拿到 12.5 万 Star 了。
这个项目把 Matt Pocock 日常使用的 AI Agent skills 打包开源,目标很明确:工程问题。
1、这项目是干嘛的
一句话:给 Claude Code 和其他 AI 编程 agent 配一套工作流。
Matt Pocock 是 Total TypeScript 的创始人,TypeScript 圈子里有影响力的教育者。他发现 AI 编程工具用起来有几个通病:理解偏差、输出啰嗦、代码质量不稳、项目越写越乱。问题不在模型不够聪明,在缺少工程化的使用方式。
于是他把自己每天用的 skills 开源。每个 skill 都很小,只干一件事,可以组合。支持任何模型,不限环境。
2、四个常见问题,它有解
项目把 agent 的常见失败模式分成了四类,每类都有对应的 skill。
理解偏差
你以为 agent 懂你要做什么,结果做出来的完全不是那回事。
解法是 /grill-me 和 /grill-with-docs。动手写代码之前,让 agent 反复追问需求细节,把每个决策分支理清楚。grill-with-docs 还会在这个过程中帮你建立项目的共享语言文档 CONTEXT.md,让以后 agent 都能用你项目的术语说话。
输出啰嗦
agent 进到一个陌生项目,不懂你们的术语,20 个字能说清的事它写 200 个字。
CONTEXT.md 治的就是这个。它把项目里的术语、缩写、命名规范全部归档。agent 看了之后输出立刻精简,token 消耗也能降下来。这个效果会持续。
代码跑不通
对齐了需求,代码还是不行。问题出在反馈循环上。
项目提供了 /tdd skill,让 agent 按红绿重构的套路来:先写测试,再写代码,测试通过了才算完。还有 /diagnose,把调试过程结构化:复现、最小化、假设、验证、修复、回归测试。
项目变成一团泥
agent 写代码太快了,快到项目的复杂度增长速度远超以往。
/improve-codebase-architecture 每隔几天跑一次,帮你找代码里可以深化的模块。/zoom-out 让 agent 从整体架构的角度解释代码,而不是盯着局部实现。/to-prd 在写设计文档之前就问你 touch 了哪些模块,防止拍脑袋改架构。
3、怎么用
安装只要一条命令:
npx skills@latest add mattpocock/skills
然后选你要的 skills 和要安装的 coding agent,运行 /setup-matt-pocock-skills 完成初始化。它会问你用哪个 issue tracker、triaged 用的 label 是什么、文档存哪。
之后就可以在日常开发里按需调用各个 skill 了。
4、适合谁
- 每天用 Claude Code、Cursor 或其他 AI 工具写代码的人
- 觉得 agent 输出不稳定、经常要返工的人
- 在团队里推广 AI 编程、需要一套工作流的人
这 12.5 万 Star 不是白来的。背后的核心理念很简单:软件工程的基本功在 AI 时代反而更重要了。模型再强,没有好的工作流配合,也只是在加速混乱。