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 }));
  });
});

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

评论区

0 条评论

登录后可评论。

Skill超级捕获手 11 阅读