mattpocock/skills Skill：让 AI 编程 Agent 产出工程级代码的技能框架

总结

mattpocock/skills 是由 TypeScript 明星布道师 Matt Pocock 维护的一套「真实工程师」技能集，专为 Claude Code、Codex 等 AI 编程 Agent 设计。与市面上追求「AI 全自动」的工具不同，它的核心理念是 Process over Prompt——把数十年软件工程经验压缩成可组合、可裁剪的模块化技能，让 AI 不再是只会「 vibe coding 」的玩具，而是能真正产出工程级代码的搭档。2026 年 5 月曾空降 GitHub Trending 榜首，当前累计约 90k⭐，周均新增仍在数千级别，是今年最炙手可热的 Skill 集合之一。

功能与原则

该项目的设计哲学是「小而专注、可组合、模型无关」：

• 小技能：每个 Skill 只做一件事（如 review、plan、refactor），而非塞进一个大而全的提示词
• 可组合：可以按需挑选安装，不强制全量覆盖，不同项目用不同技能组合
• 模型无关：核心提示词不绑定特定模型，Claude Code、Codex、Gemini CLI 等均可使用
• 工程经验驱动：所有 Skill 来自 Matt Pocock 在 Vercel 时期及开源项目（tsx、ts-pattern、valibot）中积累的真实工程规范，而非纸上谈兵的设计

认可度

• GitHub stars：约 90,064⭐（截至 2026-08-19），2026 年 5 月 GitHub Trending 月榜第 1 名
• 周新增：单周增长约 +19,679⭐（2026 年 5 月上半月），日均增长约 947⭐（2026 年 7 月）
• Newsletter 订阅：约 60,000 名开发者订阅了更新通知
• Claude Code 官方市场：已收录至 Claude Code 官方插件市场，开箱即用，无需手动配置
• 讨论热度：GitHub Issues 活跃，Skills 目录持续更新，社区贡献频繁

链接

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

Claude Code 插件：mattpocock-skills（官方市场直接安装）

原作者

Matt Pocock（GitHub: mattpocock）

• 前 Vercel 工程师，TypeScript 领域顶级布道师
• 维护着 tsx、ts-pattern、valibot 等热门开源项目
• 在 YouTube / Twitter 拥有大量开发者粉丝，是「TypeScript 入门」领域的标杆人物
• 2025-2026 年凭借 AI 编程工具教育内容迅速出圈，Newsletter 读者逾 6 万

介绍

传统的 AI 编程 Agent 虽然能生成代码，但往往缺乏对「什么是好工程」的判断力——代码能跑，但不一定符合团队规范、不一定有测试、不一定考虑了边界情况。

mattpocock/skills 的出现正是为了解决这个问题。项目包含 30+ 专项技能，覆盖：

• Engineering 技能：代码评审（review）、重构（refactor）、并行化改造（parallelize）、测试生成（test）
• Workflow 技能：变更计划（plan）、文件规划（plan-with-files）、自动化文档生成
• 运维技能：错误处理（error-handling）、生产问题排查（production-debugging）

每个技能目录下都有对应的 CLAUDE.md 和参考文档，AI Agent 在执行任务时会自动加载这些上下文。Matt 在项目 README 中明确写道：「Developing real applications is hard. These skills are designed to be small, easy to adapt, and composable. They work with any model. They’re based on decades of engineering experience.」

特点

• 小而专注：每个 Skill 只解决一个工程问题，不做臃肿的超级提示词
• 工程级评审：内置代码规范检查（Standards Review）和需求对照检查（Spec Review），双维度并行
• 可编辑：通过 npx skills@latest add mattpocock/skills 安装到项目目录，开发者可自由修改、fork
• 零配置接入 Claude Code：官方市场直接安装，自动订阅更新，无需手动克隆仓库
• 跨 Agent 兼容：除 Claude Code 外，支持 Cursor、Codex、Gemini CLI、Windsurf、Cline 等 9+ 平台

使用方法

方式一：Claude Code 官方插件（推荐，开箱即用）

# 在 Claude Code 会话中
/plugin install mattpocock-skills

或全局安装：

claude plugins install mattpocock-skills

方式二：npm 安装（项目级，可编辑）

npx skills@latest add mattpocock/skills
# 按提示选择要安装的技能和目标 Agent

安装后，在 Claude Code 中遇到对应任务时，Skill 会自动激活。例如发起 code review 时，Agent 会加载 skills/engineering/review/ 下的提示词和参考规范。

查看全部可用技能：

安装后在项目 .claude/skills/ 目录下查看，或者访问 https://github.com/mattpocock/skills/blob/main/README.md

使用场景与人群

适用场景：

• 团队引入 AI 编程 Agent 但缺乏工程规范约束
• 希望 AI 生成的代码自带测试和审查流程
• 需要将代码规范从人工 review 转向 AI + 人工双轨 review
• 想要在多个项目间统一 AI 编程行为的质量基线

目标用户：

• 使用 Claude Code / Codex 等 AI 编程工具的专业开发者
• 工程团队 Leader 希望统一代码质量标准
• TypeScript / Node.js 项目（技能以 TS/JS 工程为主）
• AI 编程教育者和内容创作者（Newsletter 订阅者中大量此类用户）

输入与输出案例

案例 1：代码评审（Standards Review）

输入（Agent 触发 review Skill）：

对 src/utils/format.ts 最近的 commit 进行代码评审

输出：

## Standards Review: src/utils/format.ts

✅ 类型安全：所有函数参数和返回值均有完整 TypeScript 类型注解
⚠️ 错误处理：formatDate() 未对极端日期（如 Invalid Date）做兜底，建议加 try-catch 或 zod schema 验证
❌ 测试覆盖：formatCurrency() 缺少边界测试，建议补充负数、超大数字用例
📖 文档：缺少 JSDoc 注释

建议优先级：Medium — 补充测试后可以 merge

案例 2：变更计划（plan-with-files）

输入（Agent 触发 plan Skill，描述需要实现的功能）：

在现有 REST API 中新增分页功能，支持 page/pageSize 参数，返回 total/totalPages 元数据

输出（Agent 读取相关文件后生成）：

## Implementation Plan: Pagination

涉及文件：
- src/routes/users.ts （路由 + 分页参数解析）
- src/services/users.ts （Service 层 + 分页查询逻辑）
- src/types/user.ts （新增 PaginationMeta 类型）

步骤：
1. 在 types/user.ts 添加 PaginationMeta interface
2. 在 services/users.ts 实现分页查询逻辑（LIMIT/OFFSET）
3. 在 routes/users.ts 添加 query 参数解析（page, pageSize）
4. 添加单元测试（覆盖率目标 > 85%）
5. 更新 OpenAPI 文档

风险点：pageSize 上限需限制防止滥用，建议 max=100

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