给真正工程师用的技能集

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

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

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

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

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

订阅 Newsletter

安装（30 秒配置）

插件安装由各 agent 按其更新机制管理；skills.sh 将可编辑的中文版技能文件复制到项目中，需要手动更新。**按 agent 选择一种安装方式，避免同一技能重复安装。**本页中文版命令均指向 devcxl/mattpocock-skills-zh。英文上游仓库 mattpocock/skills 的 Claude Code 官方市场命令不适用于中文版。下列 Claude Code、Codex、Copilot、VS Code、Gemini CLI 和 skills.sh 路线参考英文上游截至 2026-10-08 的支持情况并改用中文版仓库源，中文版路线尚未逐项实测。所有托管插件路线都要等 .claude-plugin/plugin.json 的 version 更新后才能获取新版本。本仓库发布工作流通过 npm run version 创建 chore: version skills 版本 PR；合并后，安装端再按各自的更新机制获取新版本。

1. 获取技能

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

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

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

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

{
  "extraKnownMarketplaces": {
    "mattpocock": { "source": { "source": "github", "repo": "devcxl/mattpocock-skills-zh" }, "autoUpdate": true }
  }
}

gemini skills install https://github.com/devcxl/mattpocock-skills-zh.git --path skills/engineering
gemini skills install https://github.com/devcxl/mattpocock-skills-zh.git --path skills/productivity

npx skills@latest add devcxl/mattpocock-skills-zh -a <agent>  # cursor, opencode, devin, windsurf, amp, pi; omit -a to choose

2. 运行安装向导

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

• 询问你要使用哪个 Issue 跟踪器（GitHub、GitLab、本地文件，或你描述的其他跟踪器）
• 询问你对工单进行分类时使用哪些标签（/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 个词的地方，一个就够。

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

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

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

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

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

#3：代码不能运行

"Always take small, deliberate steps. The rate of feedback is your speed limit. Never take on a task that's too big."

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

问题所在：假设你和智能体已经就构建什么对齐了。当智能体仍然产出垃圾时怎么办？

是时候看看你的反馈循环了。没有对它产出的代码实际运行情况的反馈，智能体会是盲飞。

修复：你需要那批通常的反馈循环：静态类型、浏览器访问，以及自动化测试。

对自动化测试来说，红绿重构循环至关重要。这是先让智能体写一个失败测试，再修复测试的环节。它能给智能体持续一致的反馈，从而产出好得多的代码。

仓库提供了 /tdd 技能，可以放进任何项目。它鼓励红绿重构，并给智能体充分指引，说明什么是好测试、什么是坏测试。

此外还有 /diagnosing-bugs 技能，它把最佳调试实践组织成一个按阶段把关、有纪律的循环。

#4：代码库变成一团泥球

"Invest in the design of the system every day."

Kent Beck，《解析极限编程》(Extreme Programming Explained)

"The best modules are deep. They allow a lot of functionality to be accessed through a simple interface."

John Ousterhout，《A Philosophy Of Software Design》(A Philosophy Of Software Design)

问题所在：大多数用智能体构建的应用都很复杂、难以修改。因为智能体可以显著加速编码，它们也加速了软件熵。代码库以空前的速度变得更复杂。

修复是一种全新的 AI 驱动开发方式：关心代码的设计。

这一点已内置到这些技能的每一层：

• /to-spec 在创建规格之前先测验你要触及哪些模块

而关键的是，/improve-codebase-architecture 会扫描代码库里的深化机会，再把候选项呈现出来。建议每隔几天在自己的代码库上运行一次。它是一次扫描而不是一次救援：在一份真正老的代码库上它会找到真实的候选，但它不会替你把泥团解开。

小结

软件工程的基本功比以往更重要。这套技能尝试把这些基本功压缩成可重复实践，帮助开发者打造更好的应用。Enjoy。

索引

这些按一个维度划分：谁能触发它们。用户调用的技能只有在你键入它们时才可达（例如 /grill-me）；它们的职责是编排。模型调用的技能可以由你触发，或者在任务契合时由智能体自动拿起来用；它们承载着可复用的纪律。一个用户调用的技能可以触发模型调用的技能，但永远不能触发另一个用户调用的技能。

Engineering

日常编码工作技能。

用户调用

• ask-matt：询问哪种技能或流程适合你的处境。是本仓库用户调用技能之上的路由器。
• grill-with-docs：盘问会话，同时构建你项目的领域模型，打磨术语并就地更新 GLOSSARY.md 和 ADR。
• triage：让 Issue 在 triage 角色状态机中流转。
• improve-codebase-architecture：扫描代码库中的深化机会，将它们以可视化的 HTML 报告呈现，然后盘问你选中的那一个。
• setup-matt-pocock-skills：为工程类技能配置本仓库（Issue 跟踪器、triage 标签、领域文档布局）。在使用其他工程技能之前，每个仓库运行一次。
• to-spec：把当前对话变成规格，并发布到 Issue 跟踪器。不访谈：只是综合你已经讨论过的内容。
• to-tickets：把任何计划、规格或对话拆成一组 tracer-bullet 工单，每条声明其阻塞边：以本地文件中的文本，或真实跟踪器上的原生阻塞链接形式编写。
• implement：按规格或工单集合构建工作，在预先约定的 seam 上驱动 /tdd，并在提交前以 /code-review 收尾。
• implement-spec：在一条集成分支上实现整份规格。把工单当任务图推进，在可领取的前沿并行运行实施者子代理以获得最大并发，最后以 /code-review 收尾。
• wayfinder：把一项远大于一次 agent 会话能装下的工作，作为一份共享的决策 ticket 地图规划到 Issue 跟踪器上：一次解析一个，直到通往目的地的路清晰。
• retro：在一次会话之后，为编码 agent 的环境（导航、自动化检查、编码规范、引导文件、工具）提出改进建议，按严重程度排序。

模型调用

• prototype：构建一个可丢弃的原型来回答一个设计问题：用于状态/逻辑问题的单文件 HTML，或用于从一个路由切换的多种激进 UI 变体。
• diagnosing-bugs：对硬核 bug 和性能回归的有纪律诊断循环：构建一个对这个 bug 变红的反馈循环→最小化→假设→插桩→修复→回归测试。
• research：针对高可信度的原始来源调查一个问题，并把发现以带引用的 Markdown 文件形式保存到仓库，作为后台 agent 运行。
• tdd：红绿重构循环下的测试驱动开发。一次一条垂直切片地构建特性或修复 bug。
• domain-modeling：主动构建并打磨项目的领域模型：对照术语表挑战术语、用边缘场景压力测试，并就地更新 GLOSSARY.md 与 ADR。
• codebase-design：用于设计深度模块的共享纪律与词汇：小接口背后的大量行为，安放在干净的 seam 上，通过这个 seam 可测。
• code-review：对一个固定点以来的 diff 进行双轴评审：规范（Standards）（它是否遵循仓库的编码规范，外加 Fowler 异味基线？）与规格（Spec）（它是否忠实地实现了原始 Issue/规格？），作为并行子 agent 运行以免互相污染。
• pr：PR body 应有的形状：以能说清变更的最小可视化做摘要，加上证明其可行的 before/after 证据，再加上合并风险判断（单向门或双向门，外加爆炸半径）。
• wizard：生成一个交互式 bash 向导，引导人类完成只有他们能执行的步骤：基础设施预置、配置凭据或 CI secrets、走过陌生的第三方控制台，或运行一次性迁移或切换。

Productivity

通用工作流工具，不限于代码。

用户调用

• grill-me：被无休止地盘问你的计划或设计，直到设计树的每个分支都被解决。
• handoff：把当前对话压缩成一份交接文档，让另一个智能体能继续这项工作。
• teach：用当前目录作为有状态的教学工作区，跨多次会话教用户一项新技能或概念。
• to-questionnaire：把你一个人答不出的决定变成一份 Markdown 问卷，交给唯一能答的人：异步填写，或开会时一起过完。它盘问的是发送对象（发给谁、要拿回什么），而不是主题本身。
• wait-what：一条消息没被接住的瞬间就触发它。智能体会用你缺失的上下文、用大白话、用你 GLOSSARY.md 的词汇重新讲一遍。

模型调用

• grilling：无休止地盘问用户的计划、决策或想法，直到设计树的每个分支都被解决。grill-me、grill-with-docs、triage、wayfinder 和 improve-codebase-architecture 背后的可复用访谈原语。
• writing-for-agents：为智能体编写文档：技能、AGENTS.md/CLAUDE.md，以及任何智能体通过指针触达的文档。