mattpocock/skills：31 万星的 Agent Skills 合集，专治 AI 写代码的 4 个老毛病

AI 写代码已经不新鲜了，难的是让它写出能长期维护的真工程。各种 GSD、BMAD、Spec-Kit 之类的方法论框架想替你把流程全包了，结果往往是控制权被拿走，流程一出 bug 很难修。

知名 TypeScript 讲师 Matt Pocock 走了另一条路：把自己每天真实在用的 Agent Skills 直接开源，mattpocock/skills。小而可组合，适配任何模型，背后是几十年的工程经验。仓库 2026 年 2 月创建，如今已有 31 万多星、2.6 万个 Fork，11 月 4 日登上 GitHub 日榜。

作者说，这些 Skills 是为了解决他反复看到的 4 个失败模式。每一项都对应一套具体做法，不是空泛的建议。

毛病一：Agent 没按你想要的做

软件开发里最常见的失败就是理解错位：你以为对方懂了，看到成品才发现完全不是那回事。AI 时代也一样，人和 Agent 之间存在沟通鸿沟。

解法是先对齐再动手：/grill-me 让 Agent 在开工前对你进行一轮详细的追问，/grill-with-docs 在此基础上再帮你建立项目的共享语言，把难讲清的决策记进 ADR（架构决策记录）。作者说这是他最常用的 Skills，每次改动前都值得跑一遍。

毛病二：Agent 话太多

项目刚启动时，开发者和业务方说着两种语言；Agent 被丢进项目后也一样，20 个词才能讲清 1 个词的意思。

解法是建立共享语言：一份术语表（GLOSSARY.md）让 Agent 把项目黑话解码成精确概念。变量、函数、文件命名随之统一，代码库更好导航，Agent 思考时花的 Token 也更少。作者说，这可能是整个仓库里最厉害的一招。

毛病三：代码跑不起来

对齐了，代码还是可能一团糟。没有反馈回路，Agent 就是在盲飞。

解法是把反馈回路钉死：/tdd 强制红绿重构循环，先写失败测试再修测试；/diagnosing-bugs 把调试包进一个分阶段推进的纪律循环：先让反馈回路在这个 bug 上变红，再最小化、假设、插桩、修复、回归测试。

毛病四：建出个大泥球

Agent 让写代码变快，也让代码库变复杂得更快。作者的解法是把设计关口前移：/to-spec 先问清你要动哪些模块再写规格；/improve-codebase-architecture 定期扫描代码库，找出值得加深的模块，生成可视化 HTML 报告供你挑选。这是一个调查工具，不是救援工具——老代码库的结它解不开，但能告诉你从哪下手。

完整 Skills 清单

用户调用的（你敲命令触发）：/ask-matt（帮你选 Skill 的路由器）、/grill-with-docs、/triage（按状态机流转 Issue）、/improve-codebase-architecture、/setup-matt-pocock-skills、/to-spec、/to-tickets（把计划拆成带阻塞关系的任务单）、/implement、/implement-spec、/wayfinder（把大块工作规划成任务地图）、/retro（复盘后建议改进 Agent 环境）。

模型调用的（Agent 按需自动取用）：/prototype（为设计问题做一次性原型）、/diagnosing-bugs、/research（对着高可信一手来源做调研并写成带引用的 Markdown）、/tdd、/domain-modeling、/codebase-design（深模块设计方法）、/code-review（标准与规格双轴评审）、/pr（PR 正文该有的样子）。

安装：30 秒搞定

Claude Code 用插件安装，之后自动更新：

claude plugin install mattpocock-skills@claude-plugins-official

Codex、GitHub Copilot、Gemini CLI 也有各自的插件或安装命令；其他 Agent 用 npx skills@latest add mattpocock/skills -a <agent>。注意插件和 skills.sh 复制文件两种方式二选一，两个都装会让每条 Skill 出现两次。

装好后在每个仓库里跑一次 /setup-matt-pocock-skills，它会问你用什么 Issue 跟踪器、triage 时打什么标签、文档存哪，配好就能直接用。

想多找几套现成的 Agent Skills 可以看看：explainx.ai 开源的 eStack，14 个免费 Agent Skills 覆盖学、做、增长三段；专治 AI 味界面的 unslop，先审计再一轮轮改；以及让 Claude Code 跨会话记住上下文的 claude-mem，11 万星的开源 AI 记忆插件。

转自 GitHub 作者 mattpocock 的文章《Skills For Real Engineers》，原文链接：https://github.com/mattpocock/skills