Matt Pocock Skills:让 AI 编码 Agent 拥有真实工程判断力的 Skill 合集
Matt Pocock 在 TypeScript 社区有超过 60,000 名订阅者,他的最新项目不是一门课程,而是一套直接塞进 AI 编码 Agent 工作流的工程化 Skill 合集——mattpocock/skills。这套 Skill 的核心哲学是:Agent 需要真正的工程知识,而不是泛泛的 prompt 模板。与 GSD、BMAD、Spec-Kit 等「替你做主」的方法论不同,这些 Skill 追求的是「小、易适配、可组合」,不绑架你的流程,只在关键节点增强你的控制力。2026 年 10 月 GitHub 斩获 277,702 颗星、23,262 次 fork,正在成为 AI 工程实践领域的新标杆。
功能与原则
mattpocock/skills 解决的是 AI 编码 Agent 最常见的失败模式——需求不对齐、代码质量失控、Agent 在代码库里迷失方向。每个 Skill 瞄准一个具体场景:
- 需求对齐:
/grill-me(非代码场景)和/grill-with-docs(工程场景)——在 Agent 开始写代码前,先来一轮「灵魂拷问」,确保双方对需求的理解完全一致 - 共享语言构建:在项目中建立术语表(glossary),让 Agent 理解项目专属行话,减少 token 消耗、提升代码一致性
- 反馈循环:
/tddSkill 强制 Agent 先写失败测试再修代码,建立红-绿-重构闭环 - 测试先行:
/test-before-commit确保改动有测试保护,防止破坏已有功能
设计原则始终如一:不接管你的流程,只增强你的能力。
认可度
- GitHub Star:277,702(截至 2026-10-06)
- GitHub Fork:23,262
- Newsletter 订阅者:约 60,000 人
- 支持工具:Claude Code(官方插件市场)、Codex、GitHub Copilot,以及所有支持 skills 标准的 Agent
- 行业地位:GitHub Trending 持续霸榜,被大量 AI 开发者社区列为必装 Skill 之一
链接
GitHub:https://github.com/mattpocock/skills
原作者
Matt Pocock(GitHub @mattpocock),TypeScript 领域知名教育者,Total TypeScript 课程创始人,在 GitHub 拥有极高影响力。他的 Skill 哲学深受《The Pragmatic Programmer》等经典工程文献影响,所有 Skill 都提炼自他多年实际开发经验。
介绍
mattpocock/skills 的诞生源于一个观察:大多数 AI 编码 Agent 框架(GSD、BMAD、Spec-Kit)试图替开发者做决定,但这样做会悄悄拿走你的控制权——一旦出问题,Agent 自己都说不清为什么。Matt 的应对方式是设计一系列「最小干预点」:每个 Skill 只在关键时刻插入,而不是把整个工作流替换掉。
以最热门的 /grill-with-docs 为例:启动时会询问你用什么 issue tracker、代码库用什么标签体系、文档存放位置——这些都是项目特有的上下文,Agent 自己猜不到。拿到这些信息后,它会建立一份共享术语表(glossary),把「materialization cascade」这样的项目黑话沉淀下来,以后对话中统一使用。这带来的好处是:变量命名一致了、Agent 消耗的 token 少了、代码库可读性也上去了。
/tdd Skill 则强制 Agent 每次改代码前先写一个失败测试,再修到测试通过,最后才重构。这不只是工程纪律——它给 Agent 提供了实时的、精确的反馈回路,避免「Agent 自以为写对了、跑起来全是 bug」的经典场景。
特点
- 模型无关:不绑定特定模型,任何支持 skills 标准的 Agent 都能用
- 小而专注:每个 Skill 只解决一个问题,不搞大而全的框架
- 两种安装方式:Claude Code 插件版(托管只读,Anthropic 官方市场自动更新)和
npx skills版(可编辑文件,完全可控) - 即插即用 per repo:每个仓库跑一次 setup,Agent 就学会你的工作流(issue tracker / 标签体系 / 文档目录)
- 社区驱动更新:Matt 在 GitHub 维护完整的 CHANGELOG,Newsletter 同步推送新 Skill
- 跨工具兼容:除 Claude Code 外,还支持 Codex、Cursor、Copilot、Gemini CLI、OpenCode 等 15+ 种 Agent
使用方法
方式一:Claude Code 官方插件(推荐小白)
# 在 Claude Code 会话中
/plugin install mattpocock-skills
或在 Claude Code 插件市场搜索 mattpocock-skills 一键安装。Anthropic 官方市场分发,有更新会自动推送。
方式二:npx 安装(推荐想深度定制的用户)
npx skills@latest add mattpocock/skills
# 勾选 setup-matt-pocock-skills 技能作为必选
这个方式会把 Skill 文件以普通 Markdown 形式写入你的项目仓库,你可以随意修改、更新,拉取最新变更只需 npx skills update。
方式三:手动安装(高级用户)
# 克隆后单独安装某个分类
cp engineering/tdd.md ~/.claude/agents/
初始化(每个仓库跑一次)
# 启动后 Agent 会自动询问:
# - 使用哪个 issue tracker(GitHub / GitLab / 本地文件 / 其他)
# - triage 时用什么标签
# - 文档保存到哪个目录
使用场景与人群
适用场景:
- 团队正在用 AI 编码 Agent(如 Claude Code)开发生产级项目,但发现 Agent 产出质量不稳定
- 项目有复杂的业务术语或领域模型,Agent 总是「听不懂人话」
- 需要在团队中推广 AI 工具,但又担心失控——这套 Skill 的「不绑架流程」哲学让你保留完全控制权
- 想建立标准化的 AI 工程实践(TDD、文档先行、需求对齐)
目标用户:
- 使用 Claude Code / Codex / Cursor 等 AI 编码 Agent 的工程师
- TypeScript / JavaScript 项目为主(Matt 是 TS 专家),但 Skill 本身是模型无关的
- 追求工程质量的开发者,而不是追求「AI 替你写代码」的 viber
输入与输出案例
案例 1:使用 /grill-with-docs 对齐需求
Input(在 Claude Code 会话中):
"/grill-with-docs:我需要给这个 React 项目加一个导出功能,能把表格数据导出成 CSV"
Output:
Agent 首先建立共享术语表:
- "materialization cascade" = 当某个 lesson 被标记为"real"时,自动在文件系统中获得一个物理位置的过程
然后基于这个术语表,Agent 会追问:
- 导出时是否需要处理分页?
- CSV 字段顺序按 UI 列顺序还是可配置?
- 空值用什么占位符?
(传统方式 Agent 会直接开始写代码,这个 Skill 强制它先确认细节)
案例 2:使用 /tdd 进行测试先行开发
Input:
"用 /tdd 实现一个 sum(a, b) 函数,返回 a + b"
Output(Agent 第一步输出):
# sum.test.ts
import { test, expect } from 'vitest';
import { sum } from './sum';
test('sum(2, 3) returns 5', () => {
expect(sum(2, 3)).toBe(5);
});
test('sum(-1, 1) returns 0', () => {
expect(sum(-1, 1)).toBe(0);
});
# 测试失败 → Agent 修复 sum() 实现 → 测试通过 → 重构
GitHub:https://github.com/mattpocock/skills
Star 数:277,702(截至 2026-10-06)
评论区
登录后可评论。