原文标题： mattpocock skills
原文内容：
真正工程师的技能
我每天用来做真正工程（而非“氛围编码”）的智能体技能。开发真正的应用程序是困难的。像 GSD、BMAD 和 Spec-Kit 这类方法试图通过掌控流程来提供帮助，但这样做却剥夺了你的控制权，并使流程中的 bug 难以解决。
这些技能的设计目标是：小巧、易于调整、可组合。它们适用于任何模型。它们基于数十年的工程经验。随意摆弄它们，让它们成为你自己的。尽情享受吧。
如果你想随时了解这些技能的更新以及我创建的任何新技能，你可以加入我的 Newsletter，与约 60,000 名开发者一起： [注册 Newsletter](https://example.com)
快速开始（30 秒设置）
运行 skills.sh 安装器：
npx skills@latest add mattpocock/skills选择你想要的技能，以及你想将它们安装到哪些编码智能体上。 确保你选择了 /setup-matt-pocock-skills。
在你的智能体中运行 /setup-matt-pocock-skills。它会：
- 询问你想使用哪个问题追踪器（GitHub、Linear 或本地文件）
- 询问你在分类工单时应用哪些标签（
/triage使用标签） - 询问你想将我们创建的任何文档保存在哪里
Bam —— 你已经准备好了。
这些技能为何存在
我构建这些技能是为了修复我在 Claude Code、Codex 和其他编码智能体中常见的失败模式。
#1：智能体没有按我的意愿行事
“没有人确切知道自己想要什么。”
—— David Thomas & Andrew Hunt，《程序员修炼之道》
问题：软件开发中最常见的失败模式是“错位”。你认为开发者知道你想要什么。然后你看到他们构建的东西——你意识到它根本没理解你。在 AI 时代，情况也是如此。你和智能体之间存在沟通鸿沟。
解决方案是进行一次“拷问式会话”——让智能体就你正在构建的内容向你提出详细问题。
解决方案是使用：
/grill-me—— 用于非代码用途/grill-with-docs—— 与/grill-me相同，但增加了更多功能（见下文）
这些是我最受欢迎的技能。它们帮助你在开始之前与智能体对齐，并深入思考你要做的变更。每次你想做变更时都使用它们。
#2：智能体过于啰嗦
“通过一种通用语言，开发者之间的对话以及代码的表达都源自同一个领域模型。”
—— Eric Evans，《领域驱动设计》
问题：在项目开始时，开发者和他们为之构建软件的人（领域专家）通常说着不同的语言。我在我的智能体上也感受到了同样的紧张感。智能体通常被直接丢进一个项目，然后边走边摸索行话。所以它们会用 20 个词来表达本来 1 个词就能说清楚的事。
解决方案是建立一种共享语言。这是一份帮助智能体解码项目中使用的行话的文档。
示例：以下是我 course-video-manager 仓库中 CONTEXT.md 的一个例子。哪个更容易阅读？
之前：“当课程中某个章节内的一个课时变为‘真实’（即在文件系统中被赋予一个位置）时，会出现一个问题。”
之后：“物化级联存在一个问题。”
这种简洁性会在一次次的会话中带来回报。这被内置到了 /grill-with-docs 中。它是一次拷问式会话，但能帮助你与 AI 建立共享语言，并将难以解释的决策记录在 ADR 中。很难解释这有多强大。它可能是这个仓库中最酷的技巧。试试看吧。
提示：共享语言除了减少啰嗦之外，还有许多其他好处：
- 变量、函数和文件使用共享语言进行一致命名
- 因此，代码库对智能体来说更易于导航
- 智能体在思考上花费更少的 token，因为它可以使用更简洁的语言
#3：代码不工作
“始终采取小而谨慎的步骤。反馈的速度就是你的速度极限。永远不要接受一个太大的任务。”
—— David Thomas & Andrew Hunt，《程序员修炼之道》
问题：假设你和智能体在要构建什么上已经对齐。当智能体仍然产出垃圾代码时会发生什么？是时候审视你的反馈循环了。如果没有关于它生成的代码实际运行情况的反馈，智能体将盲目飞行。
解决方案：你需要通常的反馈循环组合：静态类型、浏览器访问和自动化测试。对于自动化测试，红-绿-重构循环至关重要。这是指智能体先编写一个失败的测试，然后修复测试。这有助于为智能体提供一致的反馈水平，从而产生更好的代码。
我构建了一个 /tdd 技能，你可以将其插入任何项目。它鼓励红-绿-重构，并为智能体提供关于什么是好测试和坏测试的大量指导。对于调试，我还构建了一个 /diagnosing-bugs 技能，它将最佳调试实践封装到一个简单的循环中。
#4：我们构建了一团泥球
“每天都要对系统的设计进行投资。”
—— Kent Beck，《解析极限编程》
“最好的模块是深的。它们允许通过一个简单的接口访问大量功能。”
—— John Ousterhout，《软件设计的哲学》
问题：大多数用智能体构建的应用程序都很复杂且难以修改。因为智能体能极大地加速编码，它们也加速了软件熵。代码库以前所未有的速度变得复杂。
解决方案是一种激进的新 AI 驱动开发方法：关心代码的设计。这被内置到了这些技能的每一层中：
/to-spec在创建规格说明之前，会询问你正在触及哪些模块- 关键是，
/improve-codebase-architecture帮助你拯救一个已经变成一团泥球的代码库
我建议每隔几天在你的代码库上运行一次。
总结
软件工程基础比以往任何时候都更重要。这些技能是我将这些基础浓缩为可重复实践的最佳努力，以帮助你交付职业生涯中最好的应用程序。尽情享受吧。
参考
这些技能在一个维度上有所区分——谁可以调用它们。用户调用的技能仅在以下情况下可访问……