Matt Pocock Skills —— 真正的工程师如何用 AI Agent 做真正的开发
项目地址：https://github.com/mattpocock/skills
Stars：99.9k | Forks：8.9k | License：MIT
作者：Matt Pocock（TypeScript 领域顶级专家、Total TypeScript 创始人）
一、这是什么？
Skills for Real Engineers 是 Matt Pocock 开源的一套 AI Agent 技能集合，直接源自他每天实际开发使用的 .claude 目录配置。这不是一套面向"氛围编程"（vibe coding）的玩具工具，而是一套经过实战打磨、面向真实工程交付的 Agent 技能框架。
与 GSD、BMAD、Spec-Kit 等方法论不同，这套技能的设计哲学是小巧、易适配、可组合——它不会试图接管你的开发流程，而是像乐高积木一样嵌入你现有的工作流，兼容任何 AI 模型，让你始终掌握控制权。
二、为什么你需要它？
Matt Pocock 基于数十年工程经验，总结了使用 AI 编码 Agent 时的四大失败模式，并针对每个模式提供了精准的解决方案：
1. "Agent 没有按我想的做" —— 对齐问题
痛点：你以为 Agent 理解了需求，但看到产出后才发现理解偏差——这在软件开发中是最常见的失败模式。
解法：grill-me 和 grill-with-docs 技能。在动手编码前，Agent 会对你进行"拷问式面试"——逐分支、逐决策地追问你的计划，直到双方达成真正的共识。grill-with-docs 还会在这个过程中帮你建立共享语言文档（Shared Language），让后续所有交互都基于统一的领域术语。
这个技巧的强大之处难以言喻——它可能是整个仓库中最酷的技术。
2. "Agent 废话太多" —— 沟通效率问题
痛点：Agent 进入项目后需要边做边猜术语和约定，导致用 20 个词描述 1 个词就能说清的事。
解法：通过 grill-with-docs 建立的共享语言文档，Agent 能解码项目中的行话和领域术语。额外收益：变量、函数和文件命名更加一致，代码库对 Agent 更易导航，Agent 思考的 Token 消耗也更少。
3. "代码跑不通" —— 反馈缺失问题
痛点：Agent 在没有反馈的情况下盲目编码，就像蒙眼开车。
解法：tdd 技能将测试驱动开发的红-绿-重构循环植入 Agent 的工作流——先写失败的测试，再修复它。配合 diagnose 技能的纪律性诊断循环（复现→最小化→假设→检测→修复→回归测试），确保产出代码的质量。
4. "代码变成一团泥球" —— 架构腐化问题
痛点：Agent 加速编码的同时也加速了软件熵的累积，代码复杂度以空前的速度增长。
解法：improve-codebase-architecture 技能定期扫描代码库，基于 CONTEXT.md 中的领域语言和 docs/adr/ 中的架构决策，发现模块深化的机会。配合 zoom-out（让 Agent 从系统全局视角审视代码）和 to-prd（在创建 PRD 前审视涉及哪些模块），从每一层关注代码设计。
三、核心技能速查手册
Engineering Skills（日常编码必备）
表格
技能 功能 使用时机
/setup-matt-pocock-skills 初始化项目配置（问题跟踪器、标签体系、文档布局） 每个仓库首次使用时
/grill-with-docs 对齐需求 + 建立共享语言 + 更新架构决策记录 每次开始新任务前
/tdd 红-绿-重构循环的测试驱动开发 开发新功能或修复 Bug
/diagnose 纪律性诊断循环处理顽固 Bug 遇到难以定位的问题
/triage 通过状态机对 Issues 进行分类 管理项目问题列表
/to-issues 将计划/PRD 拆分为可独立执行的 GitHub Issues 任务拆解
/to-prd 将对话上下文合成为 PRD 并提交为 Issue 需求文档化
/improve-codebase-architecture 发现代码库架构优化机会 每隔几天运行一次
/zoom-out 让 Agent 从全局视角解释代码 理解陌生代码模块
/prototype 构建可丢弃的原型验证设计 技术方案选型时
Productivity Skills（通用工作流）
表格
技能 功能 效果
/grill-me 对非编码计划进行无情面试 确保决策树每个分支都被解决
/caveman 超压缩通信模式 减少约 75% 的 Token 使用量
/handoff 将当前对话压缩为交接文档 让另一个 Agent 无缝接力
/write-a-skill 创建符合规范的新技能 扩展自己的技能库
四、快速上手教程（30 秒设置）
第一步：安装技能
在你的终端中运行：
bash
复制
npx skills@latest add mattpocock/skills
第二步：选择技能
安装器会提示你选择：
想要安装哪些技能（建议全部安装，按需使用）
目标编码 Agent（Claude Code、Cursor 等）
务必选择 /setup-matt-pocock-skills —— 这是其他所有工程技能的前置依赖。
第三步：运行初始化配置
在你的 Agent 中执行：
plain
复制
/setup-matt-pocock-skills
它会依次询问你三个关键配置（每次只问一个，简单易懂）：
A. 问题跟踪器（Issue Tracker）
选项：GitHub（默认）/ GitLab / 本地 Markdown 文件
这是 to-issues、triage 等技能读写任务的地方
B. 分类标签（Triage Labels）
定义你在整理 Issues 时使用的标签词汇
用于 /triage 技能的状态机分类
C. 文档位置（Domain Docs）
确定 CONTEXT.md（共享语言文档）和 docs/adr/（架构决策记录）的存放位置
所有工程技能都会读取这些文档来理解你的项目
第四步：开始使用
配置完成后，你就可以在 Agent 中随时调用任何技能了：
plain
复制
/grill-me 我想重构用户认证模块
/tdd 实现购物车结算功能
/diagnose 这个 API 响应偶尔慢 3 秒
/improve-codebase-architecture
五、核心设计理念
这套技能的设计根植于软件工程的经典智慧：
"没有人确切知道自己想要什么" —— David Thomas & Andrew Hunt,《程序员修炼之道》
"使用通用语言，开发者与领域专家的对话以及代码表达都源于同一个领域模型" —— Eric Evans,《领域驱动设计》
"始终采取小而审慎的步骤。反馈速率是你的速度上限。" —— David Thomas & Andrew Hunt
"每天投资于系统设计。最好的模块是深模块——通过简单的接口提供大量功能。" —— Kent Beck / John Ousterhout
Matt Pocock 将这些经过几十年验证的工程基础，浓缩为 Agent 可执行的、可重复的最佳实践。
六、适合谁用？
使用 Claude Code、Cursor、GitHub Copilot 等 AI 编码工具的专业开发者
对 "vibe coding" 产出的质量不满意，希望用工程纪律驾驭 AI 的团队
需要维护长期项目而非一次性原型，关注代码可维护性的工程师
希望减少 AI 交互中的 Token 浪费，提升开发效率的开发者
七、参与社区
订阅 Matt Pocock 的通讯邮件（约 60,000 名开发者）：https://www.aihero.dev/s/skills-newsletter
关注项目动态，新技能持续更新中
MIT 协议完全开源，可自由修改和扩展
一句话总结：这不是一套让 AI 替代你思考的工具，而是一套让 AI 与你在同一工程标准下协作的技能框架——帮助你和 Agent 对齐理解、建立共享语言、保持反馈循环、关注架构设计，最终交付真正可靠的软件。