Matt Pocock开源39个AI编程技能：直接搬出自己的.agents目录，专治AI编码四大翻车现场

TypeScript 圈的老熟人 Matt Pocock（Total TypeScript 作者）最近干了一件挺有意思的事：把他自己每天在用的 .agents 目录原封不动搬上了 GitHub，开源了一个叫 mattpocock/skills 的仓库。仓库描述写得很直白："Skills for real engineers. Straight from my .agents directory"——给真实工程师的技能，直接来自我的 .agents 目录。项目采用 MIT 协议，最新提交停留在 10 月 9 日，累计 545 次提交，发布后迅速冲上 GitHub Trending。

他要解决什么问题

Pocock 在 README 里立了一个靶子：GSD、BMAD、Spec-Kit 这类流程框架试图"接管"你的开发流程，但代价是剥夺了你的控制权，流程本身出 Bug 时反而难以排查。他的思路相反——技能要小、易改、可组合，适用于任何模型，用他自己的话说："基于数十年的工程经验，随意改造，变成你自己的东西。"

整套技能（共 39 个）围绕他总结的 AI 编码四大失败模式 展开，每个都对应经典软件工程著作的处方：

失败模式一：Agent 没做你想要的事。 解法是"盘问式"对齐——/grill-me 会对你的计划进行穷尽式访谈，把模糊需求逼成明确规格；/grill-with-docs 更进一步，在盘问的同时构建项目领域模型。他称后者"可能是这个仓库里最酷的技术"。

失败模式二：Agent 太啰嗦。 解法是建立共享语言。仓库自带 GLOSSARY.md（术语表），团队和 Agent 用同一套领域词汇沟通。README 给了一个直观的对比：改造前是一长串"课程章节里的课时在文件系统里被实体化"的绕口描述，改造后三个词搞定——"materialization cascade"（实体化级联）。

失败模式三：代码跑不通。 解法是经典的红-绿-重构测试循环 /tdd，以及硬骨头 Bug 的诊断循环 /diagnosing-bugs。引用的是《程序员修炼之道》里的原则："反馈速率就是你的速度上限，永远别接太大的任务。"

失败模式四：建成"泥球"架构。 解法是 /to-spec（把对话转成正式规格）和 /improve-codebase-architecture（扫描代码库寻找"深化"模块的机会，生成 HTML 报告），背后是 John Ousterhout《软件设计哲学》的名言："最好的模块是深的——简单接口背后藏着大量功能。"

39 个技能长什么样

技能分两大类，每类又按调用方式分成用户主动调用（输斜杠命令）和模型自动调用两种：

Engineering 类是日常写码的主力：/ask-matt 做技能路由，不知道用哪个就用它；/triage 把 issue 按角色状态机流转；/implement 按规格和工单驱动开发，内部会自动调起 /tdd 和 /code-review；/implement-spec 更激进，能在单一集成分支上以任务图方式并发实现整个规格；/wayfinder 专门规划超大工作量；/retro 则在每次会话后建议如何改进你的 Agent 环境。模型自动调用的包括 prototype（一次性原型）、research（高可信来源调研并产出引用文档）、code-review（双轴评审，并行子代理）、wizard（生成交互式 bash 向导）等。

Productivity 类偏通用工作流：/handoff 把长对话压缩成交接文档，/teach 做多会话教学，/wait-what 在你没看懂 Agent 的话时让它用平实语言重讲一遍——这个技能的名字本身就很有态度。

怎么装

安装号称"30 秒设置"，对主流 AI 编码智能体都有对应的安装方式：

  • Claude Code：claude plugin install mattpocock-skills@claude-plugins-official，默认自动更新；
  • Codex / GitHub Copilot：通过各自的 plugin marketplace 添加 mattpocock/skills；
  • Gemini CLI：gemini skills install 分别装 engineering 和 productivity 两个目录；
  • 其他智能体（Cursor、Windsurf、OpenCode、Devin、Amp 等）：npx skills@latest add mattpocock/skills -a <agent>。

装完每个仓库跑一次 /setup-matt-pocock-skills，配置你用的 issue tracker（GitHub、GitLab 或本地文件）、triage 标签和文档位置即可。注意每个智能体只能选一种安装方式，否则技能会装重。日常建议很简单：改代码前先 /grill-me 对齐，写码用 /tdd，调 Bug 用 /diagnosing-bugs，隔几天跑一次 /improve-codebase-architecture。

为什么值得看

这个仓库的价值可能不在于你直接装来用（当然也可以），而在于它展示了一种成熟的"人机协作工程观"：不把 AI 当魔法，而是把几十年的工程基本功——需求对齐、统一语言、TDD、每日投资设计——翻译成 Agent 能执行的可复用流程。用 Pocock 的话收尾："软件工程基本功比以往任何时候都重要。这些技能是我把这些基本功浓缩成可重复实践的最佳努力。"

在满屏"XX 框架接管一切"的声音里，这种"小工具 + 你的掌控权"路线，反而显得清醒。

来源：GitHub mattpocock/skills 仓库 README（2026年10月）