乐于分享
好东西不私藏
夜雨聆风 > > 办公文件 > AI编程Skills库,84.2k Stars

AI编程Skills库,84.2k Stars

当前时间： 2026-08-11 01:32:41 分类：办公文件 评论(0)
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 认为最酷的技术

具体做法就是三步：

  1. 创建 CONTEXT.md：定义项目中所有专业术语的精确含义
  2. 编写 ADR：记录每个架构决策的背景和理由
  3. 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 内建
✅ 完整知识库
❌
❌
架构治理
✅ 主动审查
❌
❌

◆ 六、最佳实践建议

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

◆ 七、总结与展望

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

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

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

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

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