Skills:给 AI Agent 配一套工程工作流

0 阅读3分钟

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 了哪些模块,防止拍脑袋改架构。

README区域截图

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 时代反而更重要了。模型再强,没有好的工作流配合,也只是在加速混乱。