今日热门仓库 📈 skills - @mattpocockuk 的真实工程师技能集。直接源自我的 .agents 目录。过去24小时：3,362 ⭐️ 总计：230,760 ⭐️ https://t.co/mTl2SxHtyC

mattpocock/skills

来源：https://github.com/mattpocock/skills

真实工程师的技能集

skills.sh (https://skills.sh/mattpocock/skills)

我每日用于真实工程实践的AI代理技能——并非“氛围编程“。开发真实的应用程序本就艰难。诸如GSD、BMAD和Spec-Kit等方法试图通过接管流程来提供帮助，但同时也剥夺了你的控制权，并使流程中的错误难以解决。

这些技能被设计为小巧、易于适配且可组合的模块。它们适用于任何模型，基于数十年的工程经验构建。尽情调试吧，让它们成为你自己的工具。享受这个过程。

如果你想跟进这些技能的更新以及我创建的任何新技能，可以加入约60,000名开发者的我的通讯列表：
注册通讯

安装（30秒设置）

两种安装方式，两种理念：

Claude Code 插件 (https://code.claude.com/docs/en/plugins) 将整套技能作为受管理的只读包安装，我会推送更新，因此你选择订阅而非复刻。

skills.sh (https://skills.sh/mattpocock/skills) 将可编辑的技能文件复制到你的项目中，以便你进行修改并使其成为你自己的工具。

选择其中一种：同时安装两者会导致每项技能重复存在。

1. 获取技能

Claude Code

claude plugins install mattpocock-skills

或在会话内执行：

/plugin install mattpocock-skills

它已上架 Claude Code 官方市场，无需额外配置，更新会自动接收。

Codex 及其他代理

npx skills@latest add mattpocock/skills

选择你需要的技能，以及要安装它们的编程代理。
安装器允许你选择要采用的技能，因此请确保 setup-matt-pocock-skills 是其中之一。
原生 Codex 插件已在规划中（参见 .agents/adr/0002-ship-as-a-claude-code-plugin.md）。

对于喜欢折腾的用户
在任何代理（包括 Claude Code）上使用同一个安装器：

npx skills@latest add mattpocock/skills

它会将技能作为你拥有和可编辑的普通文件写入你的仓库。没有任何更新会背着你发生；当你需要时，使用 npx skills update 拉取我的最新更改。

2. 运行 /setup-matt-pocock-skills

在你的代理中，每个仓库运行一次。它会：

• 询问你想使用哪个问题追踪器（GitHub、Linear 或本地文件）
• 询问你在分类票据时使用哪些标签（/triage 使用标签）
• 询问你希望将我们创建的文档保存在哪里

3. 搞定 - 你已准备就绪。

这些技能为何存在

我构建这些技能是为了修复我在 Claude Code、Codex 和其他编程代理中观察到的常见故障模式。

#1: 代理未能执行我想要的操作

“没人确切知道自己想要什么”
—— David Thomas & Andrew Hunt，《程序员修炼之道》(https://www.amazon.co.uk/Pragmatic-Programmer-Anniversary-Journey-Mastery/dp/B0833F1T3V)

问题所在。软件开发中最常见的故障模式是错位。你以为开发者明白你的需求，但当你看到他们构建的东西时——你才意识到他们完全没理解你。在AI时代也是如此。你和代理之间存在沟通鸿沟。

解决方案是进行一次深度质询会议——让代理向你提出关于你正在构建什么的详细问题。

解决方法是使用：

• /grill-me - 用于非代码用途
• /grill-with-docs - 与 /grill-me 相同，但增加了更多功能（见下文）

这些是我最受欢迎的技能。它们帮助你与代理在开始之前就达成一致，并深入思考你将要进行的更改。每次当你想进行更改时，都使用它们。

#2: 代理过于啰嗦

借助一种通用语言，开发者之间的对话和代码的表达都源自同一个领域模型。
—— Eric Evans，《领域驱动设计》(https://www.amazon.co.uk/Domain-Driven-Design-Tackling-Complexity-Software/dp/0321125215)

问题所在：在项目初期，开发者和软件构建对象（领域专家）通常说着不同的语言。我在与代理合作时也感受到了同样的张力。代理通常被投入项目中，需要自己摸索专业术语。因此它们会用20个字来表达只需1个字就能说清的内容。

解决方案是建立一种共享语言。这是一份帮助代理解码项目中使用术语的文档。

示例
这是我的 course-video-manager 仓库中的一个 CONTEXT.md (https://github.com/mattpocock/course-video-manager/blob/076a5a7a182db0fe1e62971dd7a68bcadf010f1c/CONTEXT.md) 示例。哪个更容易阅读？

• 修改前：“当课程某一章节内的课程被‘实例化’（即在文件系统中被分配一个位置）时，存在问题”
• 修改后：“存在实例化级联问题”

这种简洁性在一次又一次的会话中都有回报。

这已内置于 /grill-with-docs 中。它是一次深度质询会议，但能帮助你与AI建立共享语言，并在ADR中记录难以解释的决策。很难解释这有多么强大。它可能是这个仓库里最酷的技巧。试一试，看看效果。

共享语言除了减少啰嗦外，还有许多其他好处：

• 变量、函数和文件命名保持一致，使用共享语言
• 因此，代码库更易于导航，对代理而言
• 代理还消耗更少的token进行思考，因为它能访问更简洁的语言

#3: 代码无法工作

“始终采取小而审慎的步骤。反馈速率是你的速度限制。绝不承担过于庞大的任务。”
—— David Thomas & Andrew Hunt，《程序员修炼之道》(https://www.amazon.co.uk/Pragmatic-Programmer-Anniversary-Journey-Mastery/dp/B0833F1T3V)

问题所在：假设你和代理已就构建内容达成一致。当代理仍然产出糟糕代码时怎么办？是时候审视你的反馈循环了。如果缺乏对其生成代码实际运行情况的反馈，代理将如同盲人摸象。

解决方案：你需要常规的反馈循环套件：静态类型、浏览器访问和自动化测试。对于自动化测试，红-绿-重构循环至关重要。这意味着代理首先编写一个失败的测试，然后修复该测试。这有助于为代理提供一致的反馈水平，从而生成更优质的代码。

我构建了一个 /tdd 技能，你可以将其集成到任何项目中。它鼓励红-绿-重构，并为代理提供了关于何为良好与糟糕测试的大量指导。

对于调试，我还构建了一个 /diagnosing-bugs 技能，它将最佳调试实践封装在一个受控的、分阶段进行的循环中。

#4: 我们构建了一团混乱

“每天都要投入系统设计。”
—— Kent Beck，《解析极限编程》(https://www.amazon.co.uk/Extreme-Programming-Explained-Embrace-Change/dp/0321278658)
“最好的模块是深思熟虑的。它们允许通过简单的接口访问大量功能。”
—— John Ousterhout，《软件设计哲学》(https://www.amazon.co.uk/Philosophy-Software-Design-2nd/dp/173210221X)

问题所在：大多数用代理构建的应用都很复杂且难以修改。因为代理能极大地加速编码，它们同时也加速了软件的熵增。代码库以前所未有的速度变得更加复杂。

解决方案是采用一种全新的AI驱动开发方法：关注代码设计。这内置于这些技能的每一层中：

• /to-spec 在创建规范之前，会询问你正在修改哪些模块
• 至关重要的是，/improve-codebase-architecture 会扫描代码库以寻找深化机会，并将候选方案呈现给你。我建议每隔几天在你的代码库上运行一次。
• 它是一次调研，而非救援：在一个真正老旧的代码库上，它会找到真实的候选点，但它不会为你理清这一团混乱。

总结

软件工程的基本原理比以往任何时候都更加重要。这些技能是我将这些原理浓缩为可重复实践的最好尝试，旨在帮助你发布职业生涯中最好的应用程序。享受这个过程吧。

参考

这些技能按一个维度划分：谁可以调用它们。
用户调用的技能仅在你输入它们时（例如 /grill-me）才可访问；它们的任务是编排。
模型调用的技能可以由你调用或在任务合适时由代理自动调用；它们包含可复用的规范。
用户调用的技能可以调用模型调用的技能，但绝不能调用另一个用户调用的技能。

工程技能

我每天用于代码工作的技能。

用户调用

• ask-matt：询问哪个技能或流程适合你的情况。本仓库用户调用技能的路由器。
• grill-with-docs：深度质询会议，同时构建你项目的领域模型，细化术语并实时更新 CONTEXT.md 和 ADRs。
• triage：将票据通过分类角色的状态机进行流转。
• improve-codebase-architecture：扫描代码库以寻找深化机会，将其呈现为可视化的 HTML 报告，然后深入质询你选择的任何一个。
• setup-matt-pocock-skills：配置此仓库以使用工程技能（问题追踪器、分类标签、领域文档布局）。在使用其他工程技能之前，每个仓库运行一次。
• to-spec：将当前对话转化为规范并发布到问题追踪器。无需访谈，直接综合你已讨论的内容。
• to-tickets：将任何计划、规范或对话分解为一组“先导弹头”票据，每张票据声明其阻塞边界，可以写为本地文件中的文本，或作为真实追踪器上的原生阻塞链接。
• implement：根据规范或票据集构建工作，在预先商定的接缝处驱动 /tdd，并在提交前通过 /code-review 进行收尾。
• wayfinder：规划一个庞大的工作块（超出单个代理会话容量），将其作为问题追踪器上的决策票据共享地图，然后逐一解决这些票据，直到通往目标的道路清晰。

模型调用

• prototype：构建一个一次性原型来回答设计问题，可以是单个可共享的 HTML 文件（用于状态/逻辑问题），也可以是多个截然不同的 UI 变体（可从一个路由切换）。
• diagnosing-bugs：用于棘手的 bug 和性能回归的规范化诊断循环：构建一个反馈循环，该循环针对此 bug 变红 → 最小化复现 → 提出假设 → 插桩 → 修复 → 回归测试。
• research：根据高可信度的一手资料调查一个问题，并将发现作为引用的 Markdown 文件捕获到仓库中，作为后台代理运行。
• tdd：测试驱动开发与红-绿-重构循环。一次一个垂直切片地构建功能或修复 bug。
• domain-modeling：主动构建和优化项目的领域模型：挑战术语对照表，用边缘场景进行压力测试，并实时更新 CONTEXT.md 和 ADRs。
• codebase-design：设计深层模块的共享规范和词汇：在小接口后隐藏大量功能，置于清晰的接缝处，可通过该接口进行测试。
• code-review：从固定点开始对差异进行双维度审查：规范（它是否遵循仓库的编码规范，加上 Fowler 代码异味基线？）和规范（它是否忠实地实现了原始问题/规范？），作为并行子代理运行以避免相互污染。
• resolving-merge-conflicts：逐个处理进行中的 git 合并或变基冲突块，通过追溯双方源头的意图来解决，然后完成操作（绝不使用 --abort）。
• wizard：生成一个交互式的 bash 向导，引导人类完成只有他们才能执行的步骤：配置基础设施、设置凭证或 CI secrets、浏览不熟悉的第三方仪表板，或运行一次性迁移或切换。

生产力

通用工作流工具，非代码专用。

用户调用

• grill-me：针对一个计划或设计进行无情的质询，直到设计树的每个分支都得到解决。
• handoff：将当前对话压缩为交接文档，以便另一个代理可以继续工作。
• teach：使用当前目录作为有状态的教学工作区，在多个会话中教授用户新技能或概念。
• to-questionnaire：将一个你无法独自回答的决定，转化为一个 Markdown 问卷，交给唯一能回答的人，可以异步填写，或在会议中共同完成。它质询你关于发送（给谁，你需要什么回来），而不是关于主题本身。
• wait-what：当一条消息未被理解时立即触发此技能。代理会用你缺失的上下文，用你 CONTEXT.md 的词汇，用简单的英语重新阐述。

模型调用

• grilling：就一个计划、决定或想法对用户进行无情的质询，直到设计树的每个分支都得到解决。这是 grill-me、grill-with-docs、triage、wayfinder 和 improve-codebase-architecture 背后的可复用质询原语。
• writing-for-agents：为代理编写文档：技能文档、AGENTS.md/CLAUDE.md，以及任何代理通过指针访问的文档。