什么是 mattpocock/skills

mattpocock/skills 是 TypeScript 社区作者 Matt Pocock 发布的一套指令包，目的是给 AI 编程助手（Claude Code、Cursor、Cline、Copilot 等）建立可执行的工作流约束。装好之后在终端输入 /指令名 即可调用。

它解决的是 vibe coding 的核心问题：AI 写代码太快、太自由、太爱解释、偶尔执行毁灭性命令——结果是项目早期跑得飞起，中后期不可维护。

什么是 vibe coding

vibe coding 是指把自然语言需求直接丢给 AI、让它生成代码并即时跑起来的写法。优点是冷启动极快，缺点是没有需求拆解、没有测试、没有版本控制护栏，代码质量随 AI 当下的 token 状态浮动。

mattpocock/skills 包含哪些指令

按职责分四组，共约 10 个核心指令：

一、规划与设计

/grill-with-docs（或 /grill-me）—— AI 反向盘问用户，逼出需求细节，生成项目专属词汇表
/to-prd —— 把对话提炼成标准产品需求文档
/to-issues —— 把需求文档拆成原子任务卡片

二、开发流程

/tdd —— 强制测试驱动开发：先写失败测试 → 写最小通过代码 → 重构
/prototype —— 快速生成一次性原型，不污染主代码库

三、效率与交接

/caveman —— 切换至极简输出模式，只说技术词、不解释、节省 token
/handoff —— 把当前会话进度压缩成可粘贴的小纸条，供下一个会话快速恢复上下文

四、纠错与安全护栏

/diagnose —— 按系统化流程重现 bug、定位病因、修复
/git-guardrails-claude-code —— 在底层拉黑 git push --force / git clean -f 等毁灭性命令

五、老代码翻新

/improve-codebase-architecture —— 通读代码库，识别臃肿与可重构点

哪些指令对入门用户最有用

四个指令覆盖约 80% 的日常场景：

写新功能前：/grill-with-docs 把需求挤干
实际动手时：/tdd 强制带测试写
遇到 bug：/diagnose 严谨排查，避免 AI 瞎猜
AI 太话痨时：/caveman 让它闭嘴干活

它为什么和 vibe coding 是对立面

vibe coding 是"凭感觉"；mattpocock/skills 是"按流程"。

每一条指令对应一个工程纪律——先想清楚再动手、先写测试再写代码、先复现再修 bug、不破坏 git 历史。这些规矩工业界写了几十年，只是 AI 编程时代被一群新进场的开发者重新发现一遍。

任何 AI 编程工具都能用吗

是的。mattpocock/skills 是与具体 AI agent 解耦的指令规范，Claude Code、Cursor、Cline、GitHub Copilot 等主流 AI 编程工具均可接入。其中 /git-guardrails-claude-code 是针对 Claude Code 终端的专门护栏，其他工具可用各自等价的命令拦截机制。

仓库地址

GitHub: github.com/mattpocock/skills