mattpocock/skills：把真实工程纪律装进AI编程助手的技能包

Skill超级捕获手 技术创作者 2026-08-21 12 阅读

mattpocock/skills 是 TypeScript 领域知名开发者 Matt Pocock（Total TypeScript 创始人、前 Vercel 工程师）把自己日常编码用的 .agents 目录直接 开源 发布的技能包。它不教 AI “写更多代码”，而是把数十年工程经验——审问式需求澄清、TDD、代码审查、领域建模——编码成可组合的 Markdown 技能文件，让 AI 按真实工程纪律干活，而非凭感觉狂飙代码。

功能与原则

mattpocock/skills 围绕四个 AI 编程经典失败模式构建，每种模式对应一个或多个 Skill：

  • 需求错位：AI 没问清楚就动手，做完发现理解错了 → /grill-me、/grill-with-docs（强制 AI 动手前审问需求，并同步建立共享词汇表）
  • 输出冗长：一个词的意思用 20 句话绕 → /grill-with-docs、/domain-modeling（共建统一术语，减少 token 消耗）
  • 无反馈环：代码跑起来全是 bug，测完才后悔 → /tdd（强制红绿重构循环）、/diagnosing-bugs（结构化调试：复现→最小化→假设→验证→修复）
  • 架构腐烂：AI 加速了代码库熵增，泥球越滚越快 → /to-spec、/improve-codebase-architecture、/wayfinder

设计哲学：每个 Skill 独立、小巧、可随意改；不绑定任何模型；把控制权留给开发者而非框架。

认可度

  • GitHub Star：约 220,000 颗（截至 2026-08-21）
  • 安装量：超过 1,300 万次（skills.sh 平台统计）
  • 周增速：单周最高 +17,900 颗星（2026 年 7 月）
  • 下载者：Newsletter 订阅超 60,000 人
  • Trending：2026 年 4-8 月多次登顶 GitHub Trending 榜首
  • Fork：约 18,000+

链接

GitHub：https://github.com/mattpocock/skills

原作者

Matt Pocock（GitHub: mattpocock）
TypeScript 领域最有影响力的布道者之一，Total TypeScript 课程创始人，曾在 Vercel 担任工程师，2026 年初创办 AI Hero 教育平台。他把自己的每日工程实践直接开源，形成了目前生态中安装量最高的 Skill 集合之一。

介绍

这个仓库的本质是一个「AI 编程防翻车急救包」。Matt Pocock 在 2026 年初重度使用 Claude Code 时，遭遇了四大经典困境：长对话后 AI 遗忘关键架构决策、需求模糊时 AI 擅自生成 500 行无关代码、AI 为交差伪造测试断言、缺乏重构流程导致代码泥球以超高速膨胀。愤怒之下，他在本地写了一系列 Markdown 指令，强制 AI 在动手前先过一遍工程纪律。

2026 年 4 月 29 日正式开源后，这个没有任何可执行代码的项目（全是 .md 技能文件）一路冲上 GitHub Trending 第一，4 个月内突破 20 万星。它不接管整个开发流程（区别于 GSD、Spec-Kit 这类框架），而是把控制权留给开发者，每个 Skill 只解决一个具体问题。

特点

  • 零依赖：纯 Markdown 文本文件，不需要 npm install，不需要运行时，AI 能读文件就能用
  • 模型无关：Claude Code、Codex、Cursor、Gemini CLI 均可用，不绑定任何厂商
  • 可改写：所有文件安装后归你所有，可以按项目需求随意修改
  • 安装量验证：13M+ 次安装，是目前实际使用率最高的 Skill 集合之一
  • Token 节省：自带 /caveman 技能，用”穴居人语言”压缩 AI 输出，可节省约 65-75% token 同时保持技术准确性
  • 中文支持：已有社区中文本地化版本（vinvcn/mattpocock-skills-zh-CN）

使用方法

方式一：Claude Code 插件市场（推荐）

/plugin marketplace add mattpocock-skills
/plugin install mattpocock-skills

方式二：skills.sh 一键安装（适用所有 Agent）

npx skills@latest add mattpocock/skills

安装过程中选择需要的 Skill，确保勾选 /setup-matt-pocock-skills，运行一次设置命令回答三个问题（问题跟踪器、分类标签、文档位置）。

方式三：手动克隆

git clone https://github.com/mattpocock/skills.git
cp -r skills/* ~/.claude/skills/

安装完成后，在 Claude Code 对话框中直接描述需求，AI 会自动调用对应 Skill；也可以手动触发特定 Skill（如 /grill-me、/tdd）。

使用场景与人群

  • 适用场景：需要 AI 编程助手完成真实工程项目，而非一次性的代码补全；需要多人协作维护代码库；团队希望 AI 遵循已有的工程规范和编码风格
  • 目标用户：使用 Claude Code、Codex、Cursor 等 AI 编程助手的工程师；希望把 AI 从”代码生成器”变成”协作伙伴”的团队；技术 leader 想要约束 AI 输出质量的工程管理者

输入与输出案例

案例一：模糊需求 → 审问式澄清

输入：

帮我添加用户认证功能

Skill /grill-me 触发后，AI 不会直接动手写代码，而是会追问：
– 这个功能需要支持哪些登录方式（邮箱、OAuth、SMS）？
– 认证状态存储在哪里，现有系统是否有 Session 机制？
– 哪些路由需要鉴权，哪些公开？
– 用户表的字段有哪些，是否需要新增字段？

直到需求完全对齐，AI 才开始写代码。

案例二：代码出现 bug → 结构化调试

输入：

这个函数在边界情况下崩溃了，帮我看看

Skill /diagnosing-bugs 触发后，AI 按五步走：
1. 复现——找到触发崩溃的最小输入
2. 最小化——消除冗余代码，精确定位问题行
3. 假设——提出可能原因
4. 验证——通过实验或断点验证假设
5. 修复——实施最小改动并确保测试通过

而非直接给出看起来对但治标不治本的”修复”。

GitHub：https://github.com/mattpocock/skills

GitHub: https://github.com/mattpocock/skills

评论区

0 条评论

登录后可评论。

Skill超级捕获手 12 阅读