Matt Pocock Skills 完整指南

TypeScript 大佬 Matt Pocock 开源的工程 Skill 集,41.5k stars,告别 vibe coding。

Matt Pocock,TypeScript 领域很有影响力的教育者,Total TypeScript 创始人,前 Vercel 工程师。GitHub 上的 TypeScript 类型体操教学影响了全球一大批开发者。

他的 skills 仓库 从自己的 .claude 目录直接开源,没做任何包装,结果短时间内冲到 41.5k stars。核心价值是把专业软件工程里的好习惯,变成 Claude Code 能直接执行的指令。

值得注意的是,这套 skills 跟 TypeScript 没什么关系——它是一套通用的工程实践,适用于任何语言和框架。

项目地址: github.com/mattpocock/skills 许可协议: MIT

安装

npx skills add mattpocock/skills

装完之后跑一次配置命令:

/setup-matt-pocock-skills

这一步会帮你配置 issue tracker、triage labels 等工程基础设施。如果你不用 GitHub Issues 做项目管理,可以跳过,不影响其他 Skill 使用。

核心 Skills 详解

Matt Pocock 的 Skill 数量不少,按用途分了三类。

工程类

diagnose — 结构化调试。不是"看看报错"那种轻量排查,而是一套完整的调查流程:收集症状、形成假设、设计验证方案、执行、确认。适合那种"现象很奇怪,不知道从哪查"的场景。

tdd — 红绿重构循环。强制你先写一个会挂的测试,再写最少的代码让它过,最后重构。不是"建议你写测试",而是"卡住你必须按这个节奏走"。如果你一直想试 TDD 但总嫌麻烦,这个 Skill 能帮你建立起习惯。

improve-codebase-architecture — 定期体检。它会深入分析代码结构,找出耦合、分层混乱、职责不清的地方。不是每天用的东西,但项目跑到一定规模之后定期跑一次,比事后大规模重构划算得多。

to-issues / to-prd — 把对话变成可执行的产物。跟 AI 聊了一通需求之后,直接让它拆成 GitHub Issue 或者 PRD 文档。比自己手动整理快,而且不会遗漏讨论过程中冒出的点。

triage — Issue 状态机管理。给 issue 打标签、设优先级、分派——这套流程在团队协作时尤其有用。一个人开发的话用处不大,除非你的 issue 多到自己管不过来。

zoom-out — 拉高视角。当你在一个文件里改了三天,已经不知道自己在全局里处在什么位置的时候,这个 Skill 会帮你重新审视当前代码和整体架构的关系。防止"只见树木不见森林"。

协作类

grill-me — 需求拷问。名字很直白:让 AI 来"盘问"你。在动手写代码之前,它会用提问的方式逼你想清楚边界条件、异常路径、优先级。很多 bug 不是代码写错了,是一开始需求就没想清楚。grill-me 在这一步卡你一下。

grill-with-docs — grill-me 的加强版。除了问你问题,还会去读你的文档和代码库,基于已有信息来提问。问出来的问题更准,但启动也更慢。

git-guardrails — 防手滑。拦截 git push --forcereset --hard、在 main 上直接 commit 这类危险操作。一个人开发也该装——凌晨三点的 git 操作最危险。

效率类

caveman — 极简模式。砍掉所有花哨的流程,只做最基础的事。官方说能省 75% 的 token 消耗。适合那些"改个配置文件""加个环境变量"之类的简单任务——不需要 AI 先做五分钟的需求分析。

write-a-skill — 教你造轮子。它会引导你走完创建一个新 Skill 的完整流程:定义触发条件、编写执行步骤、设定输出规范。如果你有什么重复性工作想固化下来,用这个起步比自己写 SKILL.md 靠谱。

它不是"提示词合集"

市面上有不少"XX 个 ChatGPT 提示词"之类的东西。Matt Pocock 的 Skills 跟那些不一样。

它背后有一套清晰的工程习惯:《The Pragmatic Programmer》里的"不要破窗"、《Domain-Driven Design》里的领域边界、TDD 的红绿重构循环、结构化调试的方法。Matt 把这些东西压缩成了 AI 能理解、能执行的流程。

核心目标就一个:让 AI 编码少一点"vibe coding"(凭感觉写代码),多一点专业软件工程的约束。

Vibe coding 指的是那种"让 AI 随便写,跑通就行"的模式。短期看效率高,长期看技术债会滚雪球。Matt Pocock 这套 Skills 的价值,就是在这个过程中帮你加上纪律。

和 baoyu-skills 的对比

如果你同时关注内容创作和代码开发,可能会在这两个 Skill 集之间犹豫。其实不用——它们的定位完全不同:

mattpocock/skillsbaoyu-skills
面向谁开发者内容创作者
解决什么代码质量、架构、测试、Git 安全配图、排版、发布、多平台分发
代表 Skilldiagnose、tdd、grill-mexhs-images、cover-image、slide-deck
底层理念软件工程最佳实践内容生产自动化

两个同时装,互不冲突。如果你既写代码又做内容(独立开发者常见),可以全部拿下。

推荐入手顺序

41.5k stars 的仓库,十几个 Skill,一上来全装不一定好。建议分步来:

第一步,先装这两个:

npx skills add mattpocock/skills --skill grill-me
npx skills add mattpocock/skills --skill diagnose

grill-me 能立刻让你感受到"需求对齐"的价值——下次跟 AI 聊需求的时候,它不会再秒出代码了,而是先把你问到烦(但问完之后代码质量会上一个台阶)。diagnose 则是在你遇到奇怪 bug 时能救命的工具。

第二步,按需加:

写测试不自觉?加 tdd。项目变大了?加 improve-codebase-architecture。经常手滑 git 操作?加 git-guardrails

不用一次全装。 Skill 不是越多越好——装太多反而会让 AI 在决策时犹豫。挑你当前最痛的点,先解决那个。

下一步