Matt Pocock Skills：面向真工程师的 AI Agent 技能集

项目地址：https://github.com/mattpocock/skills  协议：MIT  Stars：264,597  Forks：22,312  更新：2026-09-17

一、产品深度介绍

（一）它是什么

Matt Pocock Skills 是 Matt Pocock 从个人 .agents 目录中整理出来、每天都在真实工程里使用的 Agent 技能集合。每个技能本质上都是一份 SKILL.md 形式的指令文件，写明「在什么场景下、按什么纪律去完成一件事」。作者把它和当下流行的 vibe coding 明确区隔开：这套东西是用来做真工程的，而不是靠运气把代码堆出来。

仓库的自我介绍非常直接：Skills for Real Engineers，Straight from my .agents directory。换句话说，这不是一份为了演示而写的示例库，而是作者本人在生产环境里反复打磨、真正在用的工具箱。它随作者的工作流一起演进，新增与调整都来自一线工程实践。

（二）理念与定位

作者认为，开发真正的应用很难。GSD、BMAD、Spec-Kit 这类方法试图通过接管整个流程来帮忙，但代价是夺走了你的掌控权，流程本身的 bug 也因此变得难以修正。Matt Pocock Skills 反其道而行：技能要小、容易改写、可组合；适用于任意模型；建立在数十年工程经验之上。作者的态度是：随便 hack，把它们变成你自己的，然后享受其中。

这种「小而易改」的哲学，意味着你不需要全盘接受一套方法论。你可以只拿走 grill 系列来做需求对齐，只拿走 tdd 来强化测试纪律，或者把任意一个技能改成本团队的表述方式。它不强加流程，只提供可复用的工程纪律。

二、主要功能特点与应用场景

整套技能按使用对象分成两大桶：工程类（Engineering，每日代码工作）与生产力类（Productivity，不限代码的通用工作流）。在每个桶内，又按「谁来触发」分成用户调用型与模型调用型两种。下面按仓库 README 的清单逐一列出。

工程类 · 用户调用型：

• ask-matt：问哪个技能或流程适合当前处境，相当于用户调用型技能的总路由。
• grill-with-docs：一场盘问式对齐会话，同时构建项目的领域模型，打磨术语并更新 CONTEXT.md 与 ADR。
• triage：让 issue 在一系列 triage 角色之间按状态机流转。
• improve-codebase-architecture：扫描代码库寻找可深化的机会，以可视化 HTML 报告呈现，再带你逐个盘问选定项。
• setup-matt-pocock-skills：为工程技能配置仓库，每个仓库只需运行一次。
• to-spec：把当前对话变成一份规格，发布到 issue 跟踪器，无需访谈，只综合你已经讨论过的内容。
• to-tickets：把任意计划、规格或对话拆成一组 tracer-bullet 工单，声明各自的阻塞边。

工程类 · 模型调用型：

• implement：按规格或一组工单推进实现，在约定接缝处驱动 /tdd，提交前以 /code-review 收尾。
• wayfinder：把远超单次 Agent 会话容量的大块工作，规划成 issue 跟踪器上的一张决策工单共享地图，逐张解题直到通路清晰。
• prototype：构建一次性原型来回答某个设计问题，可以是单个可分享的 HTML 文件，也可以是同一路由下可切换的多个 UI 变体。
• diagnosing-bugs：针对难缠 bug 与性能回退的纪律化诊断循环。
• research：面向高可信一手来源调查问题，把结论写成带引用的 Markdown 文件，作为后台 Agent 运行。
• tdd：红—绿—重构循环的测试驱动开发，一次只做一个垂直切片。
• domain-modeling：主动构建并打磨项目领域模型，拿术语挑战术语表，用边界场景做压力测试。
• codebase-design：设计深模块的统一纪律与词汇：少量行为藏在小的接口之后，放在干净的接缝处，并能通过该接口测试。
• code-review：对固定基准点之后的 diff 做双轴评审，标准轴看是否遵循仓库规范，规格轴看是否忠实实现原始 issue 或规格。
• resolving-merge-conflicts：逐块处理进行中的 git merge 或 rebase 冲突，按意图追溯到双方一手来源，再完成操作。
• wizard：生成一个交互式 bash 向导，带人走完只有人能执行的步骤。

生产力类 · 用户调用型：

• grill-me：被人 relentlessly 盘问计划或设计，直到设计树的每个分支都被解决。
• handoff：把当前对话压缩成一份交接文档，让另一个 Agent 接续工作。
• teach：跨多场会话教用户一个新技能或概念，用当前目录作为有状态的教学工作区。
• to-questionnaire：把一个人答不了的决定，变成给那个能答的人的 Markdown 问卷。
• wait-what：当一句话没接住时立刻触发，Agent 用你缺失的上下文、用你 CONTEXT.md 里的词汇重新讲一遍。

生产力类 · 模型调用型：

• grilling：对用户计划、决定或想法 relentlessly 访谈，直到设计树每个分支解决，是 grill-me、grill-with-docs 等技能的复用原语。
• writing-for-agents：为 Agent 写文档：skills、AGENTS.md/CLAUDE.md，以及任何 Agent 通过指针到达的文档。

典型应用场景包括：动手前用 grill 系列做需求对齐、用 to-spec 与 to-tickets 把想法落到规格与工单、用 tdd 与 diagnosing-bugs 建立反馈循环、用 code-review 与 codebase-design 守住质量、用 research 与 domain-modeling 沉淀知识，以及用 handoff 与 teach 做交接与带教。

三、如何安装与使用

作者给出两条路线、两种哲学。Claude Code 插件把整套技能作为受管的只读捆绑安装，随作者发布而更新，相当于订阅而非 fork；skills.sh 则把可编辑的技能文件复制进你的项目，让你可以 hack 并据为己有。两条只选其一，都装会让每个技能出现两份。

路线一，Claude Code 插件（订阅式，只读托管，自动更新）：

claude plugins install mattpocock-skills

或在会话内执行：

/plugin install mattpocock-skills

它在 Claude Code 的官方市场里，无需先添加任何东西，更新会自动到达。

路线二，skills.sh（可编辑，落在你自己的仓库）：

npx skills@latest add mattpocock/skills

安装器会让你挑选要哪些技能、装到哪些编码 Agent 上。它支持的不仅是 Claude Code，也包括 Codex 等其它 Agent。注意：安装器允许你选择要拿哪些技能，务必确保 setup-matt-pocock-skills 也在其中。同一套安装器也适用于爱折腾的人：

npx skills@latest add mattpocock/skills

它会把技能作为你拥有并可编辑的普通文件写进仓库，没有任何东西在背后偷偷更新；想拉取作者最新改动时用 npx skills update 即可。

装好后，在每个仓库里运行一次初始化：

/setup-matt-pocock-skills

它会问你三件事：用哪个 issue 跟踪器（GitHub、Linear 或本地文件）、triage 时给工单打的标签、以及生成的文档存到哪里。这一步是后续工程技能生效的前提。

四、官方地址与获取方式

• GitHub 仓库：https://github.com/mattpocock/skills
• skills.sh 安装器：npx skills@latest add mattpocock/skills
• Claude Code 市场插件：claude plugins install mattpocock-skills
• Newsletter：作者约 60,000 名开发者的订阅信，用于跟进技能变更与新技能

五、与同类方案对比

把 Matt Pocock Skills 和两类常见方案放在一起看，差异主要在「是否接管流程」与「技能形态」上。

一句话总结：流程接管型框架替你做主但拿走掌控，通用 Prompt 库灵活却无纪律；Matt Pocock Skills 取中间路线，把工程纪律做成可调用、可改写的小单元。

六、核心机制深度解析

整套技能最关键的设计，是用户调用型与模型调用型的二分。用户调用型技能只有当你键入时才能被触达（例如 /grill-me），它的职责是编排；模型调用型技能既可以由你触发，也能在任务契合时由 Agent 自动取用，承载可复用的纪律。一个用户调用型技能可以去调用模型调用型技能，但绝不会去调用另一个用户调用型技能。

作者构建这些技能的初衷，是为了修正编码 Agent 常见的失败模式。README 里点名了两类：其一是「Agent 没做你想要的事」，根因是沟通错位，解法是一场盘问式对齐（grill 系列）；其二是「代码跑不起来」，根因是缺少反馈循环，解法是静态类型、浏览器访问与自动化测试，尤其是一个红—绿—重构循环（tdd），以及一套分阶段的纪律化调试（diagnosing-bugs）。

把这些技能串起来，就是一条清晰的工作流：先用 grill 对齐，再用 to-spec / to-tickets 落到规格与工单，然后用 implement 在 tdd 的节奏里推进，提交前以 code-review 收口，过程中用 codebase-design 与 improve-codebase-architecture 守住架构。

七、实用技巧

• 两条路线二选一：Claude Code 插件与 skills.sh 不要同时装，否则每个技能会出现两份。
• setup 只跑一次：工程类技能在第一个仓库里先跑 /setup-matt-pocock-skills，选好 issue 跟踪器、triage 标签与文档落盘位置，后续技能才能用。
• 要可改写就走 skills.sh：文件落在你仓库里，你拥有并随意改；想省事就走插件，随作者发布自动更新。
• 用 ask-matt 做路由：不确定该用哪个技能时，先问 ask-matt，让它帮你定位合适的技能或流程。
• 把 grill 当固定动作：每次动手改动前先对齐，先想清楚再写代码，能显著减少返工。
• 保持同步：skills.sh 路线用 npx skills update 拉取作者最新改动，不必重新全量安装。

八、最新更新动态

仓库用 changesets 加 @changesets/cli 做发布管理：push 到 main 时自动开一个 version PR（不发布 npm），让发布说明带上每次技能变更。近期值得关注的变化包括：

• 新增 implement-spec（in-progress 桶）：带一份规格与其工单，驱动它们汇成一个 PR；把工单当作任务图，让 implementer 子代理在 ready frontier 上并发推进。
• 统一去掉长破折号：把仓库里所有 em-dash 移除，改为自然断句，让句子读起来更顺。
• 持续打磨文档：AGENTS.md 与 README 反复修订，并忽略 .claude（存放 settings.local.json 与 Agent 工作树，永不提交）。
• 规划原生 Codex 插件：详见 .agents/adr/0002-ship-as-a-claude-code-plugin.md，目标是让 Codex 也像 Claude Code 一样一键装。

九、常见问题 FAQ

十、总结

Matt Pocock Skills 把「数十年的工程经验」压成一组小、可组合、可改写的 Agent 技能，并且刻意不接管你的流程。它的价值不在于某个单一神技，而在于把对齐、规格、TDD、评审、架构、调试这些工程纪律，做成既能由 Agent 调用、也能自己 hack 的复用单元。对想要认真做工程、又想借 Agent 提速的人来说，这是一套值得装进 .agents 目录的技能集。

在撰写本文的过程中，我主要参考了 mattpocock/skills 的 GitHub 仓库 README 与公开文档，以及 GitHub API 返回的 Stars、Forks、语言与协议等元数据。文中数据以官方公开信息为准，可能随版本更新而变化。仓库地址：https://github.com/mattpocock/skills