mattpocock/skills：让 AI Agent 做真正的工程而不是 vibe coding

mattpocock/skills 是由 Matt Pocock（TypeScript 社区知名贡献者）维护的一套面向 AI 编程 Agent 的工程化 Skill 集合，核心理念是”让 AI Agent 做真正的工程，而不是 vibe coding”。与 GSD、BMAD、Spec-Kit 等强调”AI 全流程接管”的方法不同，这套 Skill 刻意保持小而精、可组合、可修改，让开发者保留对代码的完整控制权，同时利用 decades 工程经验来引导 AI 输出高质量代码。Skill 覆盖版本控制、代码审查、Bug 修复、测试编写等工程关键环节，适配 Claude Code、Codex、Cursor 等主流 Agent。

功能与原则

mattpocock/skills 坚持三条设计原则：small（每个 Skill 只做一件事）、adaptable（文件形式交付，开发者可直接编辑）、composable（Skill 之间可以自由组合）。所有 Skill 均为 Shell 脚本或 Markdown 配置文件，安装后写入仓库作为普通文件存在，不依赖任何运行时框架，也不强制绑定特定模型。这意味着你可以 fork、修改，甚至完全不用某个 Skill——真正的”工具箱”而非”黑盒”。

认可度

截至 2026 年 9 月 8 日，GitHub 达到 256,243 Stars，长期稳居 GitHub 全站 Top 20。2026 年 9 月 5 日单日新增 2,757 Stars，是当天 GitHub 涨星最快的仓库之一。Matt Pocock 的 newsletter 订阅者超过 60,000 人，是 AI + TypeScript 领域最有影响力的独立开发者品牌之一。Skill 已在 Claude Code 官方插件市场发布（mattpocock-skills），无需手动配置即可安装更新。

链接

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

原作者

Matt Pocock（GitHub: @mattpocock），前 Vercel TypeScript 工程师，TypeScript 社区核心贡献者，专注于”让 TypeScript 被大众所用”。他同时运营 aihero.dev，是 AI + 开发工具领域最受关注的独立博主之一。

介绍

传统的 AI 编程 Agent 倾向于接管整个开发流程——从需求到代码到测试全包。这种方式在 Demo 场景下看起来很美，但一旦线上出现问题，Agent 留下的代码往往难以追溯、难以修改、难以交给人类工程师维护。Matt Pocock 在多年一线工程实践中看到了这个痛点，决定把自己日常使用的 .agents 目录中的 Skill 全部开源，形成了这套”工程优先”的解决方案。

Skill 集合包含多个垂直方向：Git 提交规范、Issue 追踪集成、代码审查流程、测试覆盖率检查等。每个 Skill 都有明确的触发条件（WHEN）和操作步骤（INVOKES），Claude Code 或其他 Agent 在满足条件时会自动调用对应 Skill，保证 AI 输出符合工程师的预期而非随意生成。Skill 还内置了”当你不确定该怎么做时，不要做”的设计哲学，避免 Agent 在缺乏信息时盲目猜测。

安装方式高度灵活：可通过 Claude Code 官方插件市场一键安装（只读订阅模式，自动同步更新），也可以通过 npx skills@latest add mattpocock/skills 将 Skill 文件直接写入仓库（可编辑模式），两种方式可以共存但建议二选一以避免 Skill 重复。

特点

• 小而精：每个 Skill 职责单一，如 fix-bug、write-tests、semantic-commit，Agent 不会因 Skill 过于宽泛而产生幻觉
• 纯文件交付：Skill 即普通 Shell/Markdown 文件，不依赖运行时，任何编辑器可直接查看和修改
• 模型无关：基于 prompt 和条件判断，不绑定 Claude/Codex，任何支持 Skill 协议的 Agent 均可使用
• 工程经验内嵌：Skill 中的判断逻辑和操作规范来自 Matt Pocock 多年一线开发经验，非通用提示词
• 社区驱动：Skill 仓库开放 PR，任何人都可以贡献自己验证过的工程实践

使用方法

方式一：通过 Claude Code 插件安装（推荐）

claude plugins install mattpocock-skills

或在 Claude Code 会话内：

/plugin install mattpocock-skills

插件会在每次 Matt Pocock 更新时自动推送，无需手动维护。

方式二：通过 skills.sh 工具安装为可编辑文件

npx skills@latest add mattpocock/skills

安装过程中会询问你使用哪个 Issue 追踪工具（GitHub/GitLab/Jira 等），Skill 会自动适配对应的 API 和命令。

验证安装

安装完成后，在 Claude Code 会话中可以直接触发 Skill，例如：

帮我修一下这个 bug：用户登录后 session 没有持久化

Agent 会自动调用 fix-bug Skill，按照预设的步骤：复现问题 → 定位根因 → 编写测试 → 修复代码 → 验证。

使用场景与人群

适用场景：

• 需要 AI Agent 参与真实项目开发（而非一次性 Demo）
• 希望 AI 输出符合团队代码规范和 Git 提交约定
• 需要 AI 在遇到不确定情况时”主动停下来”而不是乱猜
• TypeScript/JavaScript 项目的自动化测试和代码审查

目标用户：

• 使用 Claude Code、Codex、Cursor 等编程 Agent 的工程师
• 希望 AI 输出质量可控、可追溯的 Tech Lead
• 追求”AI 辅助而非 AI 替代”工程文化的团队

输入与输出案例

案例 1：Bug 修复

Input：

这个函数在并发调用时会返回 undefined：function getUser(id) { return users[id]; }

Agent 调用 fix-bug Skill 后：

• 先要求提供最小复现步骤
• 定位到缺少并发锁
• 在修复前先写测试覆盖并发场景
• 修复后运行测试验证
• 提交信息格式：fix: add mutex lock in getUser to handle concurrent access

案例 2：提交规范

Input：

commit message: 改了一些东西

Agent 调用 semantic-commit Skill 后：

• 识别出这不符合语义化提交规范
• 要求选择类型（fix/feat/docs/refactor）
• 生成：fix: resolve race condition in user session retrieval

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

Star：256,243（截至 2026-09-08）

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