Mattpocock Skills Zh

本仓库由 devcxl 维护，是 Matt Pocock 的 mattpocock/skills 项目的第三方简体中文汉化版，非官方仓库。以下中文版安装方式均指向本仓库；英文原版见上游仓库。

Matt Pocock 的智能体技能集面向真正的工程实践，而非 vibe coding。

开发真正的应用很难。GSD、BMAD、Spec-Kit 等方法试图通过接管流程来帮忙。但在这么做的同时，它们剥夺了你的控制权，并且让流程中的 bug 极难排查。

这些技能的设计原则是：小巧、易定制、可组合。它们兼容任何模型。它们基于数十年的工程经验打磨而成。尽管折腾、改造成你自己的。Enjoy。

想关注 Matt Pocock 发布的新技能与上游动态，可订阅他的 Newsletter（上游 README 标注约 60,000 名开发者订阅）：

安装（30 秒配置）

两种方式，两种理念。Claude Code 插件 将整套技能集作为受管理的只读 bundle 安装，来源是本仓库自带的 marketplace。skills.sh 将可编辑的中文版技能文件复制到你的项目中，便于自行修改。二选一：两者都装会导致每个技能出现两次。

1. 获取技能

Claude Code

claude plugin marketplace add devcxl/mattpocock-skills-zh
claude plugin install mattpocock-skills@mattpocock

或者在 Claude Code 会话中：

/plugin marketplace add devcxl/mattpocock-skills-zh
/plugin install mattpocock-skills@mattpocock

以上命令从本仓库的 marketplace 安装中文版插件，不是从 Claude Code 官方市场安装英文版。

Codex 及其他智能体

npx skills@latest add devcxl/mattpocock-skills-zh

选择你想要的技能，以及要安装到哪些编程智能体上。安装器会让你选择要装的技能：务必把 setup-matt-pocock-skills 选上。

原生 Codex 插件已在规划中：详见 .agents/adr/0002-ship-as-a-claude-code-plugin.md。

喜欢折腾的

使用同样的安装器，在任何智能体上安装：包括 Claude Code：

npx skills@latest add devcxl/mattpocock-skills-zh

这会将技能作为普通文件写入你的仓库，归你所有，你可以自由编辑。不会有任何东西在后台偷偷更新；想获取最新变更时，运行 npx skills update 即可。

2. 运行安装向导

在你的智能体中运行它，每个仓库执行一次。Claude Code 插件用户可运行 /mattpocock-skills:setup-matt-pocock-skills，通过 skills.sh 安装的用户可运行 /setup-matt-pocock-skills。它会：

询问你要使用哪个 Issue 跟踪器（GitHub、Linear 或本地文件）
询问你对工单进行分类时使用哪些标签（/triage 会用到）
询问你希望把创建的文档保存在哪里

3. 搞定：可以开工了。

这些技能存在的原因

上游项目将这套技能定位为解决 Matt Pocock 在 Claude Code、Codex 及其他编程智能体中观察到的常见失败模式。

#1：智能体没按需求做事

"No-one knows exactly what they want"

David Thomas & Andrew Hunt，《程序员修炼之道》(The Pragmatic Programmer)

问题所在。软件开发中最常见的失败模式是错位。你以为开发者知道你想要什么。然后你看到他们构建的东西：你意识到他们根本没理解你。

在 AI 时代也是一样的。你和智能体之间存在沟通鸿沟。修复办法是盘问会话（grilling session）：让智能体就你要构建的东西向你提出详细的问题。

修复就是使用：

/grill-me：用于非代码场景
/grill-with-docs：和 /grill-me 一样，但增加了更多内容（见下文）

上游项目将这两项列为最受欢迎的技能。它们帮助你和智能体在开始前先对齐，并深入思考正在进行的修改。每次你想做修改时都可以使用它们。

#2：智能体太冗长

With a ubiquitous language, conversations among developers and expressions of the code are all derived from the same domain model.

Eric Evans，《领域驱动设计》(Domain-Driven-Design)

问题所在：在一个项目的开始，开发者和他们正在为之构建软件的人（领域专家）通常说的是不同的语言。

使用智能体时也会遇到同样的张力。智能体通常被丢进一个项目，需要现场弄懂其中的行话。所以它们用 20 个词的地方，一个就够。

修复是建立一套共享语言。它是一份帮助智能体解码项目中使用的行话的文档。

示例

这是一个术语表的例子（在那个 pinned commit 里还叫 CONTEXT.md，早于技能重命名这个约定），来自 Matt Pocock 的 course-video-manager 仓库。哪一份更容易读？

之前："There's a problem when a lesson inside a section of a course is made 'real' (i.e. given a spot in the file system)"
之后："There's a problem with the materialization cascade"

这种简洁在一场又一场会话中都会奏效。

这套东西已经内置到 /grill-with-docs 里。它是一场盘问会话，但帮你和 AI 建立共享语言，并把难以解释的决定记录到 ADR 里。

要解释这东西有多强大很难。它可能是这个仓库里最酷的一项技术。试一下就知道了。

Tip

一套共享语言除了减少冗长之外还有很多好处：

变量、函数和文件的命名一致，使用共享语言
因此代码库对智能体来说更容易导航
智能体也花更少 token 来思考，因为它能用到更简洁的语言