Skills For Real Engineers 是 Matt Pocock 面向专业工程师推出的 AI Agent 技能库，来自他每天在 .claude 目录中使用的实践集合。它不是 GSD、BMAD 那样的重型流程框架，而是一组小而美、可组合、可自由改造的技能，用 /grill-me、/tdd、/diagnose 等命令对齐需求、驱动红绿重构、规范排查缺陷，且不绑定特定模型。
Skills For Real Engineers 是什么
一句话答案：Skills For Real Engineers（仓库名 Matt Pocock Skills）是 Matt Pocock 推出的面向专业工程师的 AI Agent 技能库，源自 Matt Pocock 日常 .claude 目录实践。
它的定位很清楚——不是 vibe coding 的玩具，而是“真正做工程”的日常工具箱。作者自述这些技能是为了修复他在 Claude Code、Codex 等编码 Agent 上反复遇到的常见失败模式。
与 GSD、BMAD 的区别
GSD、BMAD、Spec-Kit 这类方法试图“接管流程”。接管的同时，也拿走了你的控制权，流程一旦出问题就很难定位。Skills For Real Engineers 走的是相反路线：
- 小而美：每个技能独立可用，不做大一统框架。
- 可组合：按需挑选、自由裁剪，适配自己的仓库。
- 可 hack：技能就是你自己仓库里的普通文件，看不懂就改。
- 模型无关：不绑定特定模型，Claude、Codex、Cursor 等均可使用。
- 工程原生：基于《The Pragmatic Programmer》《Domain-Driven Design》等经典工程原则，而不是 prompt 技巧堆砌。
产品定位
面向已有真实工程习惯的开发者：用静态类型、自动化测试、红绿重构等真实反馈约束 Agent，避免它“盲目飞行”。技能库本身不提供托管服务，也不替你决定架构，它只提供一套可复用的对话与流程接口。
核心功能
技能以斜杠命令形式提供给 Agent，主要分为几组。
需求对齐
/grill-me：通过高强度追问会话，在编码前彻底对齐需求与决策分支，非编码场景也能用。/grill-with-docs：在 grilling 基础上共建项目共享语言和架构决策记录（ADR）。/zoom-out：要求 Agent 跳出局部代码，从系统整体视角给出解释。
开发与验证
/tdd：驱动 Agent 执行红绿重构循环，以垂直切片方式逐次构建功能或修复缺陷。/diagnose：规范化的诊断闭环——复现→最小化→假设→插桩→修复→回归测试。/prototype：快速构建可运行的终端原型或多种 UI 变体以验证设计。
任务与规划
/triage：基于状态机对 Issue 进行分级分派，支持自定义标签词汇。/to-prd：将当前对话上下文自动合成为 PRD 并提交为 GitHub Issue。/to-issues：把计划或 PRD 拆分为可独立认领的垂直切片任务。
架构与协作
/improve-codebase-architecture：依据 CONTEXT.md 和 ADR 识别模块深化机会，治理架构泥球。/caveman：极致压缩通信模式，在保持技术精度的前提下削减约 75% token 消耗。/handoff：将当前会话压缩为交接文档，便于其他 Agent 无缝续作。/teach：以当前目录为状态化教学空间，分多会话教授新技能或概念。/write-a-skill：按规范结构创建新技能，支持渐进式披露与资源打包。
共享语言机制
通过 CONTEXT.md 建立项目术语体系，是这套技能里最被作者看重的一招。作者观察到的现象是：Agent 通常被直接丢进项目里，边做边猜行业黑话，于是本来 1 个词就能讲清的事，它要用 20 个词去表达。
举例来说，把“课程某个 section 里的 lesson 被 made real”改写为“materialization cascade 出问题了”，一句话就能省下大量解释成本，而且这种精简会随会话一次次复利。共享语言还会带来：变量、函数、文件命名一致；代码库对 Agent 更好导航；Agent 思考时消耗的 token 更少。
如何使用 Skills For Real Engineers
有两条进入路径，对应两种哲学，二者只能选一个。
路径一：Claude Code 插件
- 整套技能以受管的只读包形式安装，作者发版即自动更新，相当于“订阅”而非 fork。
- 它已在 Claude Code 官方市场，无需先添加来源，更新自动到达。
- 原生 Codex 插件在路线图中（见
.agents/adr/0002-ship-as-a-claude-code-plugin.md）。
路径二：skills 安装器
运行 npx skills@latest add mattpocock/skills，选择目标 Agent 并勾选 /setup-matt-pocock-skills。安装器让你自己挑技能、挑要装到哪些编码 Agent 上；技能会以普通文件写进你的仓库，由你拥有、可编辑，不会在背后自动更新，需要时用 npx skills update 拉取最新改动。
注意：两条路径同时安装会让每个技能出现两份。
初始化与日常节奏
- 在 Agent 中执行一次
/setup-matt-pocock-skills，每个仓库运行一次。它会问你：用哪个 Issue 追踪器（GitHub、Linear 或本地文件）；triage 时打什么标签（/triage依赖这些标签）；生成的文档存到哪个目录。 - 每次变更前，用
/grill-me或/grill-with-docs对齐需求。 - 开发过程中用
/tdd保障质量。 - 遇到 bug 用
/diagnose启动规范化诊断。 - 架构维护上，定期运行
/improve-codebase-architecture防止代码腐化。
整套安装与配置约 30 秒可完成，支持 GitHub、Linear 或本地文件作为 Issue 追踪器。
适用场景
- 需求对齐与规划：项目启动或功能变更前，通过
/grill-me或/grill-with-docs与 Agent 高强度追问，确保双方对需求、决策分支和领域术语完全对齐。 - 测试驱动开发：需要保证代码质量时，用
/tdd驱动 Agent 执行红绿重构循环，以垂直切片逐次构建功能或修复缺陷，让每次变更都有自动化测试守护。 - 复杂 Bug 诊断：遇到难以复现的性能回退或逻辑缺陷时，用
/diagnose走完整诊断闭环。 - 架构持续治理：在大型、长期维护的代码库里定期运行
/improve-codebase-architecture，依据 CONTEXT.md 和 ADR 识别模块深化机会，避免 Agent 加速腐化。 - 跨会话协作：用
/handoff压缩会话、用/caveman压降 token，适合长任务和多人多 Agent 接力。
优点
- 轻量可组合：拒绝重型框架，每个技能独立可用，可自由裁剪适配。
- 模型无关：Claude、Codex、Cursor 等均可使用。
- 工程原生：建立在经典工程原则之上，而非 prompt 技巧。
- 共享语言机制：CONTEXT.md 显著降低 Agent 沟通成本与 token 消耗。
- 反馈闭环：强调静态类型、自动化测试、红绿重构等真实反馈。
- 易于改造：skills 路径下技能就是你仓库里的可编辑文件。
局限
- 它是一组技能，不是端到端流程管理器；没有共享语言、ADR 纪律的团队需要自行维护 CONTEXT.md 与决策记录。
/triage的标签体系依赖初始化时的配置，配置不当会影响分级效果。- 两条安装路径互斥，混装会产生重复技能。
- 原生 Codex 插件尚在路线图，Codex 用户当前走技能文件安装路径。
- 具体支持范围、命令细节与更新节奏可能变化。
价格与可用性核验提示
本次事实表中未给出任何价格、订阅费用或授权条款信息，因此不作推测。是否收费、许可方式、可用的安装渠道与最新版本状态，请直接到产品官网 https://github.com/mattpocock/skills 及你所用 Agent 的官方插件市场页面复核后再做决定。
常见问题（FAQ）
它会绑定某个模型吗？
不会。官方表述是模型无关，Claude、Codex、Cursor 等均可使用。
装完就能直接用吗？
还需要初始化。请在 Agent 中执行一次 /setup-matt-pocock-skills，配置 Issue 追踪器、分级标签和文档目录，之后 /triage 等技能才能按你的约定工作。
我该选插件还是安装器？
想跟随作者更新、接受只读托管包，选 Claude Code 插件；想拥有并改造文件、自己控制更新时机，用 npx skills@latest add mattpocock/skills。两者不要同时装。
它和 GSD、BMAD 冲突吗？
作者的设计意图是提供替代思路：GSD、BMAD、Spec-Kit 通过接管流程来帮忙，也因此收走了控制权并让流程内的问题难以解决；这套技能选择小而美、可组合、可 hack。是否混用取决于你的团队纪律。
最值得先试的是哪个技能？
作者认为 /grill-with-docs 可能是整个仓库里最强的技巧：它既是追问会话，又帮你与 AI 共建共享语言，并把难以解释的决策写进 ADR。
替代方案
- GSD、BMAD、Spec-Kit：试图接管开发流程的重型框架，控制权更少，流程问题更难定位。
- 一泽 Eze 开源的 Agent Skill：聚焦“思考如何上网”。
- Jesse Vincent 开源的 Agentic 技能框架与软件开发方法插件。
- 专为 AI 编码助手设计的开源 AI 设计 Skill。
- 通用做法：自己维护一套 .claude 或项目级技能文件，按团队习惯拼装。
一手资料
- 产品官网与仓库：https://github.com/mattpocock/skills
如果你想跟进这套技能的变化以及作者新创作的技能，可以加入他约有 60,000 名开发者订阅的 newsletter。
常见问题
Skills For Real Engineers 会不会绑定某个模型？
不会。它的官方表述是模型无关，Claude、Codex、Cursor 等均可使用。
安装完就能直接用吗？还需要做什么配置？
还需要初始化。请在 Agent 中执行一次 /setup-matt-pocock-skills，它会询问使用哪个 Issue 追踪器（GitHub、Linear 或本地文件）、triage 时使用什么标签、以及文档保存目录，完成后 /triage 等技能才能按你的约定工作。
Claude Code 插件和 skills 安装器该选哪个？
两者对应两种哲学，只能选一个。Claude Code 插件把整套技能作为受管的只读包安装，作者发版时自动更新；skills 安装器（npx skills@latest add mattpocock/skills）把可编辑的技能文件复制进你的仓库，由你掌控并可用 npx skills update 拉取更新。同时安装会让每个技能出现两份。
它和 GSD、BMAD 有什么区别？
GSD、BMAD、Spec-Kit 通过接管流程来提供帮助，但也因此拿走了你的控制权，使流程中的问题难以解决。这套技能坚持小而美、可组合、可 hack，不绑定流程，每个技能独立可用。
为什么共享语言被认为这么重要？
作者观察到 Agent 常被直接丢进项目、边做边猜术语，本来 1 个词能说清的事它要用 20 个词表达；用 CONTEXT.md 建立共享语言后，命名更一致、代码库更好导航、Agent 思考也更省 token，这种精简会随会话持续复利。
如果只先试一个技能，推荐哪个？
作者认为 /grill-with-docs 可能是整个仓库里最强的技巧：它既是高强度追问会话，又帮你与 AI 共建项目共享语言，并把难以解释的决策记录进 ADR。
