mattpocock/skills:让 AI 做真正的工程而不是 vibe coding 的技能集
Skills for Real Engineers(mattpocock/skills)是 Matt Pocock 开源的一套可组合式 AI 编程技能集,专为真实工程场景设计,不是” vibe coding”。区别于 AutoGPT 类通用 Agent 工具,它把需求澄清、领域语言对齐、TDD 闭环、架构评审、系统化调试等 decades 级工程经验封装成小型独立 Skill,可按需安装到 Claude Code、Codex 等编码 Agent 中。近一个月狂卷 +50.5k stars,总量突破 235k(截至 2026-08-25),GitHub Trending 连续多周霸榜,Newsletter 订阅者超 6 万人,是当前 AI Agent Skills 生态里最火的项目。
功能与原则
mattpocock/skills 解决的核心问题是”AI 和你对要做的事理解不一致”——这是软件工程最常见的失败模式。整套技能库遵循三条设计原则:
- 小而独立:每个 Skill 只做一件事,可单独安装/卸载,不需要全套
- 可 hack:所有 Skill 文件是普通文本,安装到本地后可随意修改
- 通用兼容:不绑定特定模型,任何支持 skill 协议的 Agent 都能用
核心 Skill 包括:/grill-me(需求拷问)、/grill-with-docs(带文档的需求对齐)、/test-with-types(类型驱动的 TDD)、/fix-broken-windows(系统化调试)、/architect(架构评审)、/review(代码 review)等,覆盖从需求到上线的完整工程闭环。
认可度
- GitHub Stars:235,350(截至 2026-08-25),月增 +50.5k,Trending 周榜多次 #1
- Forks:20,052
- Newsletter 订阅:~60,000 人
- 8 月多篇技术媒体(稀土掘金、IT之家、Capital Peak)深度报道,GitHub Trending 周榜持续在列
链接
GitHub:https://github.com/mattpocock/skills
原作者
Matt Pocock(GitHub @mattpocock),TypeScript 布道者、前 Vercel 工程师,以”让 AI 做真正的工程而不是生成代码”为理念创建了本项目。个人网站 https://skills.sh,Newsletter https://www.aihero.dev/s/skills-newsletter。
介绍
软件开发最大的坑不是写代码,而是”你以为你说了,实际上 AI 没听懂”。mattpocock/skills 就是来解决这个问题的。作者 Matt Pocock 在多年的 TypeScript 培训和工程实践中发现,AI Agent 最常见的失败模式是需求理解偏差——你给一个指令,Agent 交出来的和你想的完全不一样。
这个项目把软件工程的 best practices 拆解成可组合的 Skill。核心思路是”先问对问题,再动手”。比如 /grill-me 会让 Agent 在动手前向你发出一连串追问,直到它完全理解你要做什么,而不是一上来就生成代码。
Skill 分两类:productivity 类(需求对齐、任务规划、文档生成)和 engineering 类(TDD、类型测试、代码 review、架构评审、调试)。每类 Skill 都是一个独立 Markdown 文件,包含触发词、执行步骤和示例,可以按需引入。
安装方式灵活:可以通过 Claude Code 官方插件市场一键安装(订阅式,自动更新),也可以用 npx skills@latest add 把可编辑文件拉到你本地(适合想自己改 Skill 的团队)。
特点
- 需求前置:用
/grill-me强制 Agent 在动手前澄清需求,从源头减少返工 - 类型驱动测试:
/test-with-types用 TypeScript 类型系统写测试,实现”测试即文档” - 系统化调试:
/fix-broken-windows提供结构化调试步骤,避免盲猜 - 架构评审:
/architect引导 Agent 分析改动对系统整体结构的影响 - 完全可控:所有文件本地可改,不依赖远程更新,适合企业内部分享定制
使用方法
方式一:Claude Code 插件安装(推荐新手)
# 在 Claude Code 内
/plugin install mattpocock-skills
# 或在 Claude Code 会话中
/claude plugins install mattpocock-skills
方式二:本地可编辑安装(推荐团队/想改 Skill 的人)
npx skills@latest add mattpocock/skills
安装后,Agent 会询问你的 issue tracker(GitHub / Linear / 本地文件)和文档保存位置,完成初始化配置。
基本调用示例
# 启动需求对齐
/grill-me
# 开始一个带类型测试的 TDD 循环
/test-with-types
# 系统化修复 bug
/fix-broken-windows
# 架构评审
/architect
使用场景与人群
- 场景:需求不清晰时的需求澄清、TDD 开发流程、代码 review、bug 调试、架构评审、文档生成
- 目标用户:长期使用 Claude Code / Codex 等编码 Agent 的工程师、技术负责人、研发效能团队;希望把团队 best practices 固化为统一工作流程的组织
不适合纯 AI 新手或只是想快速生成简单脚本的用户——它假设你有工程背景和 TDD/架构评审的概念。
输入与输出案例
案例 1:需求对齐
输入(用户):
/grill-me
我想给我们的电商网站加一个库存预警功能
Agent 输出(追问):
在开始之前,我需要澄清几个问题:
1. "库存预警"是指库存低于某个阈值时触发吗?阈值是固定值还是可配置的?
2. 预警触发后希望做什么——发通知?自动下架?还是有其他动作?
3. 这个功能需要支持批量商品还是单个 SKU?
...
案例 2:类型驱动测试
输入:
/test-with-types
请为 `calculateDiscount` 函数写测试
Agent 输出(TypeScript 类型测试文件):
import { describe, it, expect } from "vitest";
import { calculateDiscount } from "./pricing";
describe("calculateDiscount", () => {
it("should apply percentage discount correctly", () => {
expect(calculateDiscount(100, { type: "percent", value: 20 })).toBe(80);
});
it("should reject negative discount values at type level", () => {
// TypeScript 会在编译期拒绝编译这个用例
expect(calculateDiscount(100, { type: "percent", value: -10 }));
});
});
评论区
登录后可评论。