mattpocock/skills —— 真实工程师的实用技能集

这是什么

mattpocock/skills 是一个开源技能集（skill set），由 TypeScript 专家 Matt Pocock 维护，专为 AI 编码代理（如 Claude Code、Codex 等）设计。它通过一系列可组合、易定制的 shell 脚本，将经典软件工程实践（如小步反馈、领域驱动设计、测试驱动开发、架构重构）封装成代理可直接调用的命令式技能。项目采用 shell 作为主要语言，在当前 GitHub 上获得 176,418 个 star，属于社区热门工程实践类工具。

安装方式分为两种哲学：一是通过 npx skills@latest add mattpocock/skills 将技能文件复制到项目目录中，允许用户直接 hack 和定制；二是作为 Claude Code 原生插件（/plugin marketplace add mattpocock/skills），以只读捆绑包形式自动更新，适合不想维护的用户。两种方式均需在代理中运行 /setup-matt-pocock-skills 完成初始配置（选择问题跟踪器、标签、文档存储位置等）。

解决的问题

项目直接回应 AI 辅助编码中的三个典型失败模式：

1. 沟通错位（Misalignment）：开发者向代理描述需求时，代理往往理解不到位，导致产出与预期相差甚远。项目引用 Pragmatic Programmer 的「没人确切知道想要什么」观点，指出这是最常见的故障。

2. 领域术语混乱：代理进入项目时缺乏对领域概念的理解，导致代码和对话中术语冗长、不一致，增加 token 消耗和误解风险。项目引用 Eric Evans 的 Domain-Driven Design 强调「统一语言」的重要性。

3. 代码熵加速（Accelerated Entropy）：代理编写代码的速度极快，但如果没有严格的工程纪律，代码库会以空前的速度变得复杂、难以修改。项目引用 Kent Beck 和 John Ousterhout 的观点，强调每日投入设计、追求深度模块。

核心功能

技能集分为两类：用户主动调用（User-invoked）和代理自动调用（Model-invoked）。核心用户技能包括：

• /grill-me：非代码场景的「拷问」会话，通过详细提问帮助用户厘清需求，与代理对齐。
• /grill-with-docs：增强版拷问，在帮助用户对齐的同时，自动构建项目的领域模型并更新 CONTEXT.md 和 ADR（架构决策记录）文件，建立统一语言。
• /to-spec：将当前对话内容转化为规范文档，并发布到问题跟踪器（GitHub、Linear 或本地文件）。
• /tdd：围绕红-绿-重构循环的测试驱动开发技能，指导代理先写失败测试再修复代码。
• /diagnosing-bugs：封装调试最佳实践，形成简单的循环流程。
• /improve-codebase-architecture：扫描代码库，识别架构改进机会，生成可视化 HTML 报告，并引导用户逐一讨论和重构。
• /triage：通过状态机管理 issue 的分类、标签和流转。
• /setup-matt-pocock-skills：一次性配置，询问问题跟踪器类型、分类标签、文档存储位置等。
• /ask-matt：路由技能，用户若不熟悉技能集，可先调用此技能询问适合当前场景的流程。

亮点 / 与同类相比

1. 基于经典工程原则，非玄学：项目直接引用了《Pragmatic Programmer》《Domain-Driven Design》《Extreme Programming》《A Philosophy of Software Design》等著作中的核心原则，将抽象理论转化为可重复执行的代理命令。相比其他 AI 代理提示词集合（如常见 prompt templates），它更强调纪律性和可维护性。

2. 双安装哲学，灵活适配：既提供复制式安装（可 hack），又提供插件式安装（自动更新）。用户可以根据团队协作风格或项目阶段选择，前者适合定制化需求，后者适合快速跟随作者的演进。

3. 领域模型构建自动化：/grill-with-docs 不仅帮助对齐需求，还自动生成和维护 CONTEXT.md 和 ADR 文件，使得代理在后续对话中能使用更精炼的领域术语，减少 token 消耗并提升代码一致性。这是项目自称「最酷的技巧」。

4. 架构维护常态化：/improve-codebase-architecture 建议每几天运行一次，主动对抗代码熵。它提供可视化的 HTML 报告，让用户直观看到架构腐化点，并引导进行重构决策。

5. 与现有工具链深度集成：支持 GitHub、Linear 等主流 issue tracker，与 Claude Code、Codex 等代理兼容，并计划推出 Codex 原生插件。

适合谁用 / 上手

适合人群：使用 AI 编码代理（Claude Code、Codex 等）进行日常开发的工程师或团队，尤其关注代码质量、长期可维护性、团队协作一致性的场景。不适合仅追求快速原型、不关心工程纪律的「vibe coding」用户。

上手路径：

1. 在项目仓库中运行 npx skills@latest add mattpocock/skills 或通过 Claude Code 插件安装。
2. 在代理中执行 /setup-matt-pocock-skills，按提示配置问题跟踪器（推荐 GitHub 或 Linear）、分类标签、文档存储路径等。
3. 开始使用核心技能：每次启动新功能前，先运行 /grill-with-docs 或 /grill-me 进行需求对齐；开发时使用 /tdd 确保测试驱动；定期运行 /improve-codebase-architecture 检查架构健康度。
4. 若不确定该用哪个技能，可先调用 /ask-matt，由代理推荐合适的流程。

项目强调「小、易适应、可组合」（small, easy to adapt, and composable），建议用户根据自身习惯修改技能文件，使其成为自己的工具。