顶级大佬把 .claude 目录里的 Skills 全开源了

今天再来聊一个新出炉的 Skills 仓库，作者是 TypeScript 圈无人不知的 Matt Pocock，仓库名简单粗暴 —— mattpocock/skills，slogan 是：Skills for Real Engineers. Straight from my .claude directory.（真正工程师用的 Skills，直接来自我的 .claude 目录）

直接把自己每天在用的那一系列配置端出来给你看，这种诚意我服

先认识一下 Matt Pocock

如果你是写前端、写全栈的工程师，大概率绕不开他

我简单梳理几个标签：

• Total TypeScript 创始人：totaltypescript几乎是英文世界 TypeScript 教学的事实标准，从 Beginner's TypeScript 免费入门，到 Total TypeScript Essentials、Pro 进阶课，再到面向库作者的 Type Transformations、Generics 专题，几乎覆盖了一个 TS 工程师从入门到 wizard 的全部路径
• TS 布道师：他在 Twitter/X 上每天发 TS 小技巧、类型体操、踩坑分享，长期是 TypeScript 话题的头部账号，很多 PR 给 TS 官方的人也跟他互相 cue
• 前 XState/Stately DX：早年在 Stately（XState 状态机背后的公司）做开发者体验，把 XState 那套相对硬核的状态机概念用人话讲清楚，那一波文档和视频影响了一代写状态机的前端
• AI Hero：现在他在做 aihero.dev，主打 AI 时代工程师的实战教学，光这个 Skills newsletter 就有大约 6 万开发者订阅
• 开源工具作者：@total-typescript/shoehorn、ts-reset 这些小而美的 TS 工具库都出自他手，社区里很多团队在用

Matt Pocock 是那种既能把类型玩到飞起，又特别擅长把复杂概念讲明白的人，他下场谈 AI 编程怎么落地，含金量是不一般

这个 Skills 仓库到底是什么

仓库名：mattpocock/skills

副标题：My agent skills that I use every day to do real engineering - not vibe coding（我每天做真工程用的 agent skills，不是 vibe coding）

Matt 自己在 README 开头放了句很有态度的话：

❝Approaches like GSD, BMAD, and Spec-Kit try to help by owning the process. But while doing so, they take away your control and make bugs in the process hard to resolve.（GSD、BMAD、Spec-Kit 这类方法论想帮你接管整个流程，代价是你失去了控制权，流程里的 bug 也变得很难处理）

他做这些 Skills 的理念正好相反：小、易改、可组合，跟任何模型都能搭

跟 Anthropic 官方那套偏完整框架的 skill、Addy Osmani 风格偏教学演示的 skill 比，Matt 的风格更像是老司机的私房 dotfile，每条都对应他在 Claude Code、Codex 这些 agent 上踩过的坑

安装方式

仓库给的是 30 秒上手版，用的是社区做的 skills.sh 安装器：

npx skills@latest add mattpocock/skills

跑完会让你勾选要哪些 skill，我直接全选！

装到哪个 agent（Claude Code / Codex 等）

然后在 agent 里执行：

/setup-matt-pocock-skills

它会问你三件事：

1. issue tracker 用啥（GitHub / Linear / 本地文件）
2. triage 时用什么 label 分类
3. 文档放在哪个目录

回答完，整套就跟你的 repo 配好了

不想用 skills.sh 也行，仓库就是标准的 Claude Code skill 结构，clone 下来扔进 ~/.claude/skills/ 或者项目里的 .claude/ 都能用

仓库分了哪几类

仓库 skills/ 下分成五个文件夹，老章看下来这个分类法本身就很值得学：

这种分层本身就是个工程实践 —— 公开推广的、私人用的、半成品的，分得清清楚楚，避免一个仓库里啥都往外推

仓库目录结构

重点是 engineering 这一组

这是 Matt 想真正给你的核心，10 个 skill，老章按他 README 里讲的 4 个失败模式串一下：

失败模式 #1：Agent 没干你想要的事 → 对齐

• /grill-me（productivity）：让 agent 反过来盘问你，把每个分支拍清楚
• /grill-with-docs（engineering）：上面的加强版，盘问的同时帮你写 CONTEXT.md 和 ADR

Matt 自己说这俩是他最常用的两个 skill，每次准备改东西前都会先跑一遍

失败模式 #2：Agent 啰嗦得要命 → 共享语言

核心思路是给项目建一份 CONTEXT.md，把项目里的"行话"沉淀下来

他举了个例子，同一句话：

• BEFORE：There's a problem when a lesson inside a section of a course is made 'real'（一节课在被"实例化"到文件系统时出问题）
• AFTER：There's a problem with the materialization cascade（materialization cascade 出问题了）

后者短得多，agent 思考用的 token 也少得多，变量、函数、文件命名也能跟着这套词汇统一，这事儿是 /grill-with-docs 顺手做的

失败模式 #3：代码就是不 work → 反馈循环

• /tdd：红绿重构循环，强制 agent 先写一个失败的测试再去修，他在 SKILL.md 里反复强调"测试要测公开行为，不要测实现细节"
• /diagnose：硬 bug 和性能回归用的诊断流，Reproduce → Minimise → Hypothesise → Instrument → Fix → Regression-test，跟一个老工程师手把手带你 debug 似的

/diagnose 六步循环

失败模式 #4：代码变成一坨泥 → 设计意识

• /to-prd：把当前对话直接整成 PRD 扔成 GitHub issue
• /to-issues：把一份大计划拆成可独立认领的 GitHub issues，垂直切片
• /zoom-out：让 agent 站到更高一层抽象上，给你画一张模块和调用关系图
• /improve-codebase-architecture：定期跑一次，找代码里"可以更深"的模块，他建议每隔几天跑一次

剩下两个：

• /triage：用状态机的方式分流 issue
• /prototype：扔一段一次性原型代码出来回答某个设计问题，要么是终端跑的状态机，要么是同一个路由下的几套 UI 变体
• /setup-matt-pocock-skills：上面提到的初始化脚手架

四大失败模式与对应 skill

productivity 这一组只有 3 个，但都很顶

• /caveman：穴居人模式，砍掉约 75% 的 token。让 agent 像聪明的穴居人那样讲话，丢掉冠词、寒暄、废话，技术信息一字不动。我看完真的笑出来了，这个想法又野又实用
• **/grill-me**：上面提过
• /write-a-skill：教 agent 怎么写一个新的 skill，meta 操作，写 skill 的 skill

misc 里有几个挺有意思

• **/git-guardrails-claude-code**：给 Claude Code 装 hook，把 git push --force、reset --hard、clean 这种危险命令在执行前直接拦掉，老章强烈建议大家把这个装上，agent 手抖一次代价太大了
• **/migrate-to-shoehorn**：把测试文件里的 as 类型断言迁到他自己写的 @total-typescript/shoehorn，TS 工程师专属
• **/setup-pre-commit**：一键搞定 Husky + lint-staged + Prettier + 类型检查 + 测试的 pre-commit hook
• **/scaffold-exercises**：批量生成练习题目录结构，他自己出课用的

跟 Anthropic 官方 skill 风格的差异

老章过一遍后的几点观感：

第一，明显是给 TypeScript / 全栈工程师写的。migrate-to-shoehorn 直接绑了他自己的 TS 库，PRD、issue、ADR 那套流程也是典型的 web 后端/全栈打法

第二，"质问 agent"的味道很重。Anthropic 官方 skill 偏向"agent 自动帮你做完"，Matt 这套反过来 —— grill-me / grill-with-docs 都是让 agent 把你按在椅子上盘问，倒逼你想清楚再动手。这其实更接近资深工程师的真实工作方式

第三，每个 skill 都很短。绝大部分 SKILL.md 是几百行内的纯 markdown，没有一堆嵌套脚本，改起来心理负担小。这点跟他在 README 里说的"小、易改、可组合"一脉相承

第四，背后引用的全是经典工程书。Pragmatic Programmer、DDD、XP、A Philosophy of Software Design，他在 README 里逐一搬出来当锚点，这就让这些 skill 不像很多"prompt 模板"那样飘在空中，它是真有底子的

老章的真诚评价

先说哪些值得直接抄：

• /grill-with-docs + CONTEXT.md 这套思路含金量最高，跨语言通用，跟 TS 没关系，建议每个用 Claude Code 的人都试一次
• /diagnose 那个六步循环，可以直接当 debug SOP 用，哪怕不接 agent，自己照着走一遍也能少走弯路
• /git-guardrails-claude-code 是保命用的，强烈建议装
• /caveman 省钱省到笑

需要注意的：

• 一部分 skill（比如 to-issues、to-prd、triage）默认假设你用 GitHub Issues 或 Linear 做项目管理，国内团队用飞书项目、Tapd、Coding 的需要自己改一下提示词
• migrate-to-shoehorn、scaffold-exercises 这些非 TS / 非课程作者基本用不上，不用纠结
• 仓库整体是英文 prompt，中文项目里直接用没问题，但如果你想让输出全中文，最好在 /setup-matt-pocock-skills 跑完后再补一句中文写作约束

总的说，这是目前我见过最像"老工程师私房菜"的一个 skills 仓库，不像很多 awesome 列表堆数量，每条都能感觉到他在自己项目里反复打磨过

skill 这个生态今年明显热起来了，从 Anthropic 官方下场，到 OpenAI 跟进，到现在 Matt Pocock 这种领域大佬把自己 dotfile 直接公开，越来越像当年大家分享 vim 配置、shell rc 的氛围，值得每一个还在跟 Claude Code / Codex 死磕的人长期跟进