mattpocock/skills：给真实工程师用的 Agent Skill

编码 agent 常见的毛病，README 归成四类：没做你想要的，话说得太多，代码跑不通，还有代码越改越乱。mattpocock/skills 是仓库所有者 mattpocock 维护的一组 Agent Skill，MIT 许可。每个 skill 是一个目录，核心是一份 SKILL.md，README 说这些 skill 设计得小、易改、可组合，任何模型都能用。README 批评 GSD、BMAD、Spec-Kit 这类框架接管流程、拿走控制权。这组 skill 是可以直接打开修改的文本，流程仍由你来定。截至 2026-10-21，仓库有 298,875 颗星，最近一次推送是 2026-10-19。

核心功能

mattpocock/skills 的每个 skill 都是独立目录，可以直接使用，也可以改写。下面五点对应 README 按问题展开介绍的几处，最后一点是一次性的仓库配置。

• 先对齐，再动手：grill-me 的 SKILL.md 只有一句话，让 agent 调用 grilling。grilling 会逐个分支地追问计划，直到每个分支都有结论。README 说这是仓库所有者最常用的 skill，并建议每次想做改动时都用一次。
• 测试先行，按缝推进：tdd 要求先写一个失败的测试，再写刚好能让它通过的代码。测试只写在事先和你确认过的 seam（接缝）上，一次只做一个纵向切片。重构不在红绿循环里，属于 code-review 的范围。
• 先找到能稳定变红的命令：diagnosing-bugs 在提假设之前，要求先做出一个能复现这个 bug 的命令，再把复现步骤缩到每一步都不可少。假设要列 3 到 5 个，并写清可以被证伪的预测。调试日志统一带 [DEBUG-xxxx] 前缀，收尾时用 grep 一次清掉。
• 架构体检，先出报告：improve-codebase-architecture 扫描代码库，找出「浅」模块（接口几乎和实现一样复杂）之类可以加深的地方，生成一份 HTML 报告，然后让你选一个再继续追问。它在你选定之前不提接口方案，流程里也没有改代码这一步。
• 一次性的仓库配置：setup-matt-pocock-skills 会问你 issue 放在哪里、用哪些分诊标签、领域文档放在哪儿，把答案写进 CLAUDE.md 或 AGENTS.md，并在 docs/agents/ 下生成对应的文档。你确认之后它才写文件。

典型使用场景

mattpocock/skills 的四种用法，都来自 README 和 SKILL.md 文件里的描述。

• 计划还模糊的人：动手写代码之前先跑 /grill-me。如果是代码改动，可以用 /grill-with-docs，README 说它会在追问的同时更新 GLOSSARY.md 和 ADR（架构决策记录）。
• 想用测试驱动功能的工程师：让 agent 使用 /tdd。这个 skill 要求在写任何测试之前，先确认测试放在哪些接缝上。
• 遇到难复现 bug 或性能回退的团队：先用 /diagnosing-bugs 建好反馈回路，再讨论修复。
• 接手老代码库的人：README 建议每隔几天在代码库上跑一次 /improve-codebase-architecture，并说它是「体检，不是救火」，不会替你理清烂泥。

快速上手

mattpocock/skills 在 Claude Code 里的安装只需要一条命令。README 给出的是：

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

插件会自动更新。装好以后，在仓库里运行一次 /setup-matt-pocock-skills。它会先看 git remote、CLAUDE.md 和 AGENTS.md，再依次问你 issue 放在哪里、用哪些分诊标签、文档怎么布局。你确认之后才写文件。Codex、GitHub Copilot、Gemini CLI 以及其它 agent 的安装命令各不相同，README 为每一个都写了一段。

小结

mattpocock/skills 适合在 Claude Code、Codex 这类编码 agent 里做真实工程、愿意读懂并改写 skill 文本的人。它不适合想要托管流程、由别人替你管项目的团队。README 对 GSD、BMAD 和 Spec-Kit 的批评，针对的正是这类框架拿走控制权的做法，而这组 skill 是可以直接打开修改的文件。它也不带测试框架，项目的验证仍然要靠你自己的测试和 CI。

用之前有几件事要留意。第一，插件安装会自动更新，用 npx skills@latest add 复制的文件则要手动更新。README 提醒同一个 agent 不要两种方式都装，否则每个 skill 会出现两次。第二，仓库里有 38 个 SKILL.md，README 的参考列表只收了 27 个。其余 11 个放在 skills/in-progress/ 和 skills/misc/ 下，README 没有介绍，要用的话先读它们的文件。第三，improve-codebase-architecture 生成的报告通过 CDN 加载 Tailwind 和 Mermaid，离线打开时样式和图表可能缺失。第四，setup-matt-pocock-skills 在 GitHub 上启用分诊标签时，会用 gh label create 在仓库里建标签，这是对远端仓库的改动，先看清列表再确认。

如果想看另一组同样用 SKILL.md 写成的工程 skill，可以读 agent-skills。这篇文章根据仓库的 README 和 SKILL.md 文件写成，编辑部没有在真实项目里运行这些 skill。