Matt Pocock Skills 完整指南
TypeScript 大佬 Matt Pocock 的工程 Skill 集，62k+ stars——告别 vibe coding，让 AI 按工程规范写代码。
Matt Pocock，TypeScript 领域很有影响力的教育者，Total TypeScript 创始人，前 Vercel Developer Advocate。GitHub 上的 TypeScript 类型体操教学影响了全球一大批开发者。
他的 skills 仓库 从自己的 .claude 目录直接开源，没做任何包装，结果短时间内冲到 62k+ stars。核心价值是把专业软件工程里的好习惯，变成 Claude Code 能直接执行的指令。
它是一套通用的工程实践，适用于任何语言和框架。
项目地址： github.com/mattpocock/skills 许可协议： MIT
图源：mattpocock/skills README，原项目使用 MIT License。
安装
npx skills add mattpocock/skills装完之后跑一次配置命令：
/setup-matt-pocock-skills这一步会帮你配置 issue tracker、triage labels 等工程基础设施。如果你不用 GitHub Issues 做项目管理，可以跳过，不影响其他 Skill 使用。
核心 Skills 详解
Matt Pocock 的 Skill 数量不少，按用途分了三类。
工程类
diagnose -- 结构化调试。不是"看看报错"那种轻量排查，而是一套完整的调查流程：收集症状、形成假设、设计验证方案、执行、确认。适合那种"现象很奇怪，不知道从哪查"的场景。
使用： /diagnose 我的应用启动报错，帮我定位根因
tdd -- 红绿重构循环。强制你先写一个会挂的测试，再写最少的代码让它过，最后重构。不是"建议你写测试"，而是"卡住你必须按这个节奏走"。如果你一直想试 TDD 但总嫌麻烦，这个 Skill 能帮你建立起习惯。
使用： /tdd 为这个用户登录函数写测试用例
improve-codebase-architecture -- 定期体检。它会深入分析代码结构，找出耦合、分层混乱、职责不清的地方。不是每天用的东西，但项目跑到一定规模之后定期跑一次，比事后大规模重构划算得多。
使用： /improve-codebase-architecture 检查当前项目架构
to-issues / to-prd -- 把对话变成可执行的产物。跟 AI 聊了一通需求之后，直接让它拆成 GitHub Issue 或者 PRD 文档。比自己手动整理快，而且不会遗漏讨论过程中冒出的点。
使用： /to-prd 把讨论写成 PRD 或 /to-issues 把 PRD 拆成开发任务
triage -- Issue 状态机管理。给 issue 打标签、设优先级、分派——这套流程在团队协作时尤其有用。一个人开发的话用处不大，除非你的 issue 多到自己管不过来。
使用： /triage 评估这些 Issue 的优先级
zoom-out -- 拉高视角。当你在一个文件里改了三天，已经不知道自己在全局里处在什么位置的时候，这个 Skill 会帮你重新审视当前代码和整体架构的关系。防止"只见树木不见森林"。
使用： /zoom-out 帮我看看这个模块在整个项目里的位置和影响
协作类
grill-me -- 需求拷问。名字很直白：让 AI 来"盘问"你。在动手写代码之前，它会用提问的方式逼你想清楚边界条件、异常路径、优先级。很多 bug 不是代码写错了，是一开始需求就没想清楚。grill-me 在这一步卡你一下。
使用： /grill-me 盘问一下我对这个需求的方案有没有漏洞
grill-with-docs -- grill-me 的加强版。除了问你问题，还会去读你的文档和代码库，基于已有信息来提问。问出来的问题更准，但启动也更慢。
使用： /grill-with-docs 基于现有代码和文档，盘问我的修改方案
git-guardrails（完整名 git-guardrails-claude-code）-- 防手滑。拦截 git push --force、reset --hard、在 main 上直接 commit 这类危险操作。一个人开发也该装——凌晨三点的 git 操作最危险。
使用： 自动生效，执行危险 git 操作时自动拦截提示
效率类
caveman -- 极简模式。砍掉所有花哨的流程，只做最基础的事。官方说能省 75% 的 token 消耗。适合那些"改个配置文件""加个环境变量"之类的简单任务——不需要 AI 先做五分钟的需求分析。
使用： /caveman 帮我修改这个配置文件 — 直接干活，跳过所有流程
write-a-skill -- 教你造轮子。它会引导你走完创建一个新 Skill 的完整流程：定义触发条件、编写执行步骤、设定输出规范。如果你有什么重复性工作想固化下来，用这个起步比自己写 SKILL.md 靠谱。
使用： /write-a-skill 把我每周写周报的流程做成一个 Skill
它不是"提示词合集"
市面上有不少"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/skills | baoyu-skills | |
|---|---|---|
| 面向谁 | 开发者 | 内容创作者 |
| 解决什么 | 代码质量、架构、测试、Git 安全 | 配图、排版、发布、多平台分发 |
| 代表 Skill | diagnose、tdd、grill-me | xhs-images、cover-image、slide-deck |
| 底层理念 | 软件工程最佳实践 | 内容生产自动化 |
两个同时装，互不冲突。如果你既写代码又做内容（独立开发者常见），可以全部拿下。
推荐入手顺序
62k+ stars 的仓库，十几个 Skill，一上来全装不一定好。建议分步来：
第一步，先装这两个：
npx skills add mattpocock/skills --skill grill-me
npx skills add mattpocock/skills --skill diagnosegrill-me 能立刻让你感受到"需求对齐"的价值——下次跟 AI 聊需求的时候，它不会再秒出代码了，而是先把你问到烦（但问完之后代码质量会上一个台阶）。diagnose 则是在你遇到奇怪 bug 时能救命的工具。
第二步，按需加：
写测试不自觉？加 tdd。项目变大了？加 improve-codebase-architecture。经常手滑 git 操作？加 git-guardrails。
不用一次全装。 Skill 不是越多越好——装太多反而会让 AI 在决策时犹豫。挑你当前最痛的点，先解决那个。
相关资源：AI 设计反模式速查
如果你用 AI 编程工具做 UI，下面这些是 AI 生成界面最常出现的问题。对照你的项目检查，大部分可一键修复。
最常见的 6 种 AI 痕迹
紫色渐变 — 蓝紫色渐变 + 深色背景 + 青色强调，已成"AI 生成"的代名词。替换为品牌色。 侧边条纹卡片 — 卡片一侧粗色块边框 + 圆角，AI 生成 UI 最明显标志。 卡片套卡片 — 无限嵌套的卡片导致视觉噪声过度。一般不超过 2 层嵌套。 通篇 Inter 字体 — 标题、正文、按钮全用 Inter，没有字体层级变化。 重复卡片网格 — 相同尺寸卡片（图标 + 标题 + 文本）无限重复，缺少变化。 AI 色板 — 紫色/蓝紫色渐变 + 青色强调，应替换为有意图的品牌色板。
核心规则
- 排版层级：标题之间至少 1.25x 比例差，正文 ≥ 16px，行高 ≥ 1.5
- 色彩：正文对比度 ≥ 4.5:1，不要用纯黑
#000做背景 - 布局：正文每行不超过 80 字符，卡片嵌套不超过 2 层
- 动效：用指数缓动（ease-out），不用弹跳缓动
- CTA：每页只有一个主要行动点，不要让所有按钮都一样强
完整 37 条反模式清单参考 Impeccable Style。
下一步
- 想看内容创作方向的 Skill → baoyu-skills 完整指南
- 想看开发者 Skill 全景 → 开发者 Skill 推荐
- 想自己写 Skill → 进阶：创建自定义 Skill