维护咨询 大模型部署 问题解决 技能定制 大模型训练
mattpocock/skills：一个TypeScript大师的Claude Code技能库，30秒配置让AI真正学会工程思维
2026年4月29日 GitHub Trending
mattpocock是谁？如果你关注TypeScript社区，应该认识他——Matt Pocock是Total TypeScript的创始人，TypeScript领域最受欢迎的教育者之一，在GitHub上拥有大量拥趸。
2026年2月，他在GitHub上开源了一个名为”Skills for Real Engineers”的项目，声称要解决Claude Code和其他AI编程助手最常见的失败模式。上线不到3个月，斩获39,928颗星，成为AI编程助手生态中最受欢迎的工具合集之一。
项目地址：https://github.com/mattpocock/skills
━━━━
一、它解决什么问题
Matt Pocock在项目说明中直接指出了AI编程助手失败的根本原因：不是AI不够聪明，而是使用方式不对。
他认为GSD、BMAD、Spec-Kit这类流程框架虽然出发点好，但它们在”接管流程”的同时也剥夺了开发者的控制权——一旦出了问题，调试起来比普通代码还难。
Skills的核心理念完全不同：技能应该是小的、容易改编的、可组合的。它们不接管你的流程，而是嵌入到你的工作流中。模型可以自己适应调整。
━━━━
二、Skills的核心哲学
Matt Pocock在README中总结了AI编程助手最常见的四类失败：
第一类：Agent没做你想要的事。给AI一个模糊指令，得到一个看起来像但实际不是想要的结果。原因是指令没有明确验收标准。
第二类：Agent输出太冗长。每次回复都是一篇论文，token烧得快，问题却没解决。caveman技能专门解决这个问题（我们之前介绍过）。
第三类：代码跑不通。AI生成的代码有bug，或者逻辑根本不对。这类问题需要系统化的诊断方法。
第四类：代码变成了意大利面。AI在大型项目中不断堆功能，最终系统变成一团难以维护的混乱。架构改进技能专门应对这种情况。
━━━━
三、三大类16个技能
Engineering类（工程技能，9个）
diagnose——系统化Bug诊断循环
这是最核心的技能之一。Matt Pocock设计了一个严格的六阶段诊断循环：
reproduce（复现）→ minimise（最小化）→ hypothesise（假设）→ instrument（插桩）→ fix（修复）→ regression-test（回归测试）
听起来像常识，但diagnose技能的强大之处在于它给出了每个阶段的具体操作指南。比如在”构建反馈循环”阶段，它列出了9种构造pass/fail信号的方法，优先级从高到低：
1. 在触及bug边界的接缝处写一个失败的测试
2. 针对运行中的开发服务器写一个curl/HTTP脚本
3. 用fixture输入调用CLI，对比已知正确输出的差异
4. Playwright/Puppeteer无头浏览器脚本
5. 回放捕获的请求追踪
6. 临时测试工具（启动系统的最小子集，用单次函数调用触发bug代码路径）
7. 属性/模糊测试循环
8. 二分法工具（如果在两个已知状态之间出现了bug，用git bisect run自动化）
9. 差异化工具（如果bug是”有时候输出错误”）
使用方式：当用户说”diagnose this”或”debug this”时触发。
tdd——测试驱动开发
红-绿-重构循环，每次做一个垂直切片功能或修复一个bug。
关键约束：每个切片必须穿过所有集成层端到端，而不是水平切某一层。
to-issues——把计划拆成GitHub Issue
把计划、规范或PRD分解成独立可领取的垂直切片Issue。
切片分两种类型：
HITL（Human In The Loop）：需要人工交互，比如架构决策或设计评审。
AFK（Away From Keyboard）：可以在无人干预下实现和合并的切片。
优先使用AFK而不是HITL。
to-prd——把讨论变成PRD
把对话上下文合成一份PRD，以GitHub Issue形式提交。不需要额外访谈，直接从已有讨论中提炼。
grill-with-docs——文档挑战
用现有领域模型挑战你的计划，厘清术语，并内联更新CONTEXT.md和ADR。
improve-codebase-architecture——架构改进
在代码库中寻找架构深化机会，基于CONTEXT.md中的领域语言和docs/adr/中的决策。
zoom-out——放大视角
让AI跳出当前细节，给出更广阔的上下文或更高层次的角度看待不熟悉的代码区域。
triage——Issue分类
通过Issue状态机进行分类。配合/setup-matt-pocock-skills配置的标签体系使用。
Productivity类（效率工具，3个）
caveman——我们已经详细介绍过（节省75% token的穴居人说话模式）。
grill-me——面试式追问
对你的计划或设计进行无情追问，直到决策树的每个分支都被解决。适合在重大决策前使用。
write-a-skill——创建新技能
用正确的结构创建新技能，包含渐进式披露和捆绑资源。教你如何把个人工作流程固化成可复用的AI技能。
Misc类（杂项工具，4个）
git-guardrails-claude-code——危险Git命令拦截
设置Claude Code钩子，在危险Git命令执行前拦截，包括push、reset –hard、clean等不可逆操作。
migrate-to-shoehorn——类型断言迁移
把测试文件从as类型断言迁移到@total-typescript/shoehorn。
scaffold-exercises——练习目录搭建
创建包含章节、问题、解答和解说的练习目录结构。
setup-pre-commit——Husky钩子配置
配置Husky pre-commit钩子，包含lint-staged、Prettier、类型检查和测试。
━━━━
四、30秒安装配置
第一步：一键安装
npx skills@latest add mattpocock/skills
这个命令会启动交互式安装器，让你选择要安装哪些技能，以及要安装到哪些编程助手（Claude Code、Codex或其他）。
第二步：选择要安装的技能
安装器会列出所有16个技能，你可以全选或按需选择。建议至少安装以下三个核心技能：
setup-matt-pocock-skills（必选，其他技能依赖它）
diagnose（必选，系统化Bug诊断）
to-issues（推荐，把计划分解成可执行的Issue）
第三步：运行初始化配置
在Claude Code中运行：
/setup-matt-pocock-skills
初始化脚本会问你三个问题：
问题追踪器选择：GitHub、Linear还是本地文件？
标签体系：你用什么标签来标记Issue的分类状态？
文档存储位置：生成的文档放在哪里？
配置完成后，所有技能就可以正常工作了。
━━━━
五、为什么Matt Pocock要做这个项目
Matt Pocock的核心观点是：AI编程助手本身没问题，问题在于使用方式。
他认为大多数人在用AI时犯的错误包括：
给模糊指令：让AI”帮我看看这段代码”不如说”这段代码在处理用户并发时出现了竞态条件，请用diagnose技能的系统化流程找出根本原因”。
缺少验收标准：AI不知道什么是”对的”，需要明确的验收测试或可执行标准。
不会放大AI的能力：AI擅长的是在明确边界内进行大规模探索，但大多数人在边界模糊时就放弃了。
Skills项目本质上是一套经过实践检验的”AI使用最佳实践”，Matt把他十几年工程经验中积累的流程固化成了一套可组合的工具。
━━━━
六、Skills vs caveman：两者是什么关系
细心读者可能发现了：mattpocock/skills中包含了一个caveman技能。而我们之前专门写了一篇介绍caveman的文章（独立项目）。
两者实际上是同一个caveman技能。Matt Pocock把它纳入了自己的技能库中，同时caveman也有独立的项目地址（github.com/JuliusBrussee/caveman）。
区别在于：独立caveman项目由JuliusBrussee维护更新，而Matt Pocock技能库中的caveman是同步自上游的副本。
使用建议：如果你只需要caveman，用独立项目；如果你想要一整套工程技能（包含caveman），用mattpocock/skills。
━━━━
七、适用人群
TypeScript/Node.js开发者：Matt Pocock的背景是TypeScript，他的技能库对这类项目特别友好。
需要系统化工作流的团队：Skills中的triage、to-issues、to-prd形成了一套完整的项目管理流程。
经常处理复杂Bug的工程师：diagnose技能把20年经验压缩成了一个可操作的六阶段框架。
想用Claude Code做正事而不是”vibe coding”的人：Matt Pocock的原话是”My agent skills that I use every day to do real engineering – not vibe coding.”
━━━━
八、常见问题
Q：Skills支持哪些AI编程助手？
A：主要支持Claude Code和Codex，其他助手（Cursor、Windsurf等）理论上也支持npx skills方式安装，但完整功能建议用Claude Code。
Q：Skills和mattpocock的TypeScript课程有什么关系？
A：Skills是他独立维护的开源项目，和Total TypeScript课程是分开的产品。Skills面向所有使用AI编程助手的工程师，不限于TypeScript。
Q： Skills和Roo、Cline等内置的技能系统有什么区别？
A：主流AI编程助手内置的技能系统是通用模板，Skills是基于真实工程经验构建的具体工作流。Matt Pocock把他修复过的真实失败模式变成了技能。
Q：Skills可以和其他技能（比如caveman）共存吗？
A：完全可以。Skills设计哲学就是可组合的，和其他技能互不干扰。
Q：企业使用有什么建议？
A：建议先在个人项目中熟悉这套技能体系，然后在团队中推广。建议先跑/setup-matt-pocock-skills配置好issue tracker，让团队成员都使用相同的标签体系，保持一致性。
━━━━
相关推荐
如果你对Matt Pocock的工作感兴趣，以下资源值得关注：
Total TypeScript：Matt Pocock的TypeScript系统课程，适合想深入TypeScript的工程师
https://www.totaltypescript.com
caveman独立项目：JuliusBrussee维护的穴居人说话技能，我们之前有详细介绍
https://github.com/JuliusBrussee/caveman
Claude Code官方文档：了解Claude Code的基本使用方式
https://docs.anthropic.com/en/docs/claude-code
crewAI：多智能体协作框架，让AI也能团队作业
https://github.com/joaomdmoura/crewAI
暂无评论内容