AI编程Skills库,84.2k Stars

Matt Pocock Skills — 84,178 Stars 的 AI 编程技能库

核心洞察：TypeScript 大神 Matt Pocock 将他每天与 AI 编码 Agent（Claude Code、Codex 等）协作用的人技能集完整开源。不是一套"替你干活"的黑盒框架，而是一组小、可组合、易修改的工程实践 —— 从需求对接到架构治理，覆盖 AI 辅助开发的完整生命周期。84,178 Stars，7,300 Forks，MIT 协议。

◆ 一、项目概述

项目名称	skills
作者	Matt Pocock（TypeScript 领域大神，Total TypeScript 创始人）
Stars	★ 84,178
Forks	7,300
许可证	MIT
安装方式	`npx skills@latest add mattpocock/skills`
官网	skills.sh

一句话：一个"真正的工程师"每天用来干活的 AI Agent 技能集合 —— 不是 vibe coding，是 real engineering。

◆ 二、为什么会有这个项目？

Matt Pocock 观察到当前 AI 编程 Agent（Claude Code、Codex 等）的四大失败模式，每个模式都对应一个工程实践：

#	失败模式	根本原因	对应技能
1	Agent 没干对	需求对齐失败	`/grill-me`
2	Agent 废话太多	没有共享语言	`CONTEXT.md`
3	代码跑不起来	缺乏反馈循环	`/tdd /diagnose`
4	代码变成泥球	架构熵增	`/improve-arch`

核心哲学

Matt 引用《The Pragmatic Programmer》和《Domain-Driven Design》中的经典观点，把这些沉淀了几十年的软件工程基本功搬到了 AI 时代：小步快跑（反馈的速度就是你的速度极限）、通用语言（Agent 和人类使用同一套术语）、每日投资设计（每天花时间改善系统设计）、深度模块（好的模块通过简单接口暴露丰富功能）。

◆ 三、技能全景图（26 个技能，5 大分类）

3.1 工程技能（Engineering）— 日常编码工作的核心

技能	命令	描述
诊断	`/diagnose`	结构化诊断循环：复现→最小化→假设→插桩→修复→回归测试
文档对齐	`/grill-with-docs`	深度提问对话，建立共享语言，自动更新 CONTEXT.md 和 ADR
问题梳理	`/triage`	通过状态机对 Issue 进行分类和分诊
架构改进	`/improve-codebase-architecture`	发现代码库改进机会，建议每几天跑一次
初始化	`/setup-...`	一键配置 Issue 跟踪器、标签和文档路径
TDD	`/tdd`	红-绿-重构循环，每次构建一个垂直切片
拆解 Issue	`/to-issues`	把计划/PRD 拆解为可独立领取的 GitHub Issue
生成 PRD	`/to-prd`	把对话内容综合成 PRD 并提交 Issue
宏观视图	`/zoom-out`	从整个系统层面解释代码
原型验证	`/prototype`	快速搭建可丢弃的原型验证设计

3.2 生产力技能（Productivity）

技能	命令	描述
穴居人模式	`/caveman`	超压缩通信，减少约 75% Token 消耗
拷问我	`/grill-me`	最受欢迎技能。被 Agent 追问直到所有决策分支被解决
交接	`/handoff`	把对话压缩成交接文档，让另一个 Agent 无缝继续
写技能	`/write-a-skill`	创建新技能的模板工具

为什么 /grill-me 是最受欢迎的技能？
Matt 引用了《The Pragmatic Programmer》中的经典观点："没有人确切知道自己想要什么"。在开始编码之前，让 Agent 像"严刑拷打"一样追问你的每一个决策细节 —— 这个过程暴露了需求中所有的模糊地带，极大减少了事后返工。

3.3 杂项与开发中技能

Git 护栏
：为 Claude Code 设置钩子，阻止危险 Git 命令（push、reset --hard 等）
Pre-commit 设置
：配置 Husky + lint-staged + Prettier + 类型检查 + 测试
练习脚手架
：创建习题目录结构（章节→问题→解答→讲解）
开发中
：4 个写作技能（review、writing-beats、writing-fragments、writing-shape）
已废弃但可学习
：设计接口、QA、重构规划、通用语言

◆ 四、技术深度解读

4.1 共享语言 — Matt 认为最酷的技术

具体做法就是三步：

创建 CONTEXT.md：定义项目中所有专业术语的精确含义
编写 ADR：记录每个架构决策的背景和理由
Agent 自动使用这些术语：变量名、函数名、文件名保持一致性

案例对比：❌ 之前："当课程某个章节中的一节课被实现（即在文件系统中有了位置）时出现问题"✅ 之后："物化级联（materialization cascade）出现问题"

共享语言的附带收益：变量/函数/文件命名一致、Agent 导航代码库更容易、Agent 推理 Token 消耗更少。

4.2 TDD 技能的内含深度

/tdd 不仅是让 Agent 写测试，它还附带了一套完整的参考材料：

tests.md
：如何写好测试的指导
deep-modules.md
：深度模块设计原则
interface-design.md
：接口设计最佳实践
mocking.md
：Mock 策略
refactoring.md
：重构方法论

这是一个完整的测试驱动开发知识库，内嵌在 Agent 技能中。

4.3 30 秒快速上手

npx skills@latest add mattpocock/skills

安装后运行 /setup-matt-pocock-skills，它会：①询问 Issue 跟踪器（GitHub / Linear / 本地）②分诊标签 ③文档保存位置。每个仓库一次配置。

◆ 五、与同类项目的对比

维度	Matt Pocock	GSD / BMAD	Spec-Kit
Stars	★ 84K	较小	较小
理念	不剥夺控制权	拥有流程	拥有流程
技能粒度	小、可组合	大、黑盒	大、黑盒
模型兼容	任何模型	特定模型	特定模型
修改难度	容易	困难	困难
共享语言	✅ 核心特性	❌	❌
TDD 内建	✅ 完整知识库	❌	❌
架构治理	✅ 主动审查	❌	❌

◆ 六、最佳实践建议

每次改动前先 /grill-me
— 花 5 分钟对齐需求，省下 2 小时返工
为项目建立共享语言
— 创建 CONTEXT.md，让 Agent 和人类"说同一种话"
TDD 是反馈循环的核心
— 红-绿-重构，让 Agent 从错误中获得实时反馈
每几天跑一次架构审查
— Agent 加速了编码，也加速了熵增，需要主动治理
用 /caveman 降低 Token 消耗
— 日常沟通减少 75% Token 开销

◆ 七、总结与展望

Matt Pocock 的 skills 仓库不仅仅是一个工具集合，它更是一份宣言：AI 时代，软件工程基本功比以往任何时候都重要。它证明了：

小技能比大框架好 — 可组合、可修改、可理解
共享语言是 Agent 协作的基石 — 没有共同术语，一切沟通都是噪音
反馈循环的质量决定了代码质量 — 类型检查、测试、TDD，一个都不能少
架构治理需要主动出击 — Agent 加速了编码，也加速了混乱

目前仓库已有 84K Stars，且持续增长。Matt 还在开发写作领域的技能，预示着这套工程实践可以扩展到更广泛的知识工作领域。

项目地址：github.com/mattpocock/skills

#MattPocock#AI编程#软件工程#开源#ClaudeCode#TDD#共享语言#TypeScript