用AI提升代码质量与架构设计

通过结构化的 AI 交互，实现更精准的代码交付、更清晰的领域语言及更稳健的架构设计。

详细介绍

Skills For Real Engineers

用于真实工程开发的 AI 代理技能集，由 Matt Pocock 日常使用。这些技能小巧、易于适应、可组合，适用于任何模型，基于数十年工程经验。

适用场景

使用 Claude Code、Codex 或其他编码 AI 代理的开发者

希望解决代理不按预期工作、回复过于冗长、代码质量差、代码库快速腐化等常见问题

需要一套可重复、可组合的工程实践来提升 AI 辅助开发效率

核心能力

工程类技能（用户主动调用）

/ask-matt — 询问当前场景适合哪个技能或流程。

/grill-with-docs — 深度访谈，同时构建项目的领域模型，精炼术语并更新 CONTEXT.md 和 ADR。

/triage — 通过状态机驱动问题（issue）的流转。

/improve-codebase-architecture — 扫描代码库找出可改进之处，以 HTML 报告呈现，并针对选中的项进行深入访谈。

/setup-matt-pocock-skills — 配置本技能集（问题跟踪器、分类标签、领域文档布局）。每个仓库运行一次。

/to-spec — 将当前对话内容转化为 specs 并发布到问题跟踪器。

/to-tickets — 将计划、specs 或对话拆分为一组 tracer-bullet 票据。

/implement — 根据 specs 或票据实现功能，在预定义接口处驱动 /tdd ，提交前执行 /code-review 。

/wayfinder — 规划超出单个会话容量的大块工作，以调查票据的形式映射到问题跟踪器。

工程类技能（模型自动调用）

/prototype — 构建可丢弃的原型来回答设计问题。

/diagnosing-bugs — 规范的调试循环：复现 → 最小化 → 假设 → 检测 → 修复 → 回归测试。

/research — 针对高可信度一手资料进行调查，并将结果以引用 Markdown 文件保存。

/tdd — 测试驱动开发，红-绿-重构循环。

/domain-modeling — 主动构建和精炼项目的领域模型。

/codebase-design — 设计深层模块的规范：小接口、大行为、可测试。

/code-review — 双轴审查：代码规范与 spec 符合度。

/resolving-merge-conflicts — 逐块解决 git 合并冲突。

生产力类技能（用户主动调用）

/grill-me — 针对计划或设计进行穷尽式访谈，直到决策树所有分支都被解决。

/handoff — 将当前对话压缩为交接文档，供另一个代理继续工作。

/teach — 在多个会话中教授用户新技能或概念。

/writing-great-skills — 编写和编辑技能的参考指南。

生产力类技能（模型自动调用）

/grilling — 穷尽式访谈循环，也用于 grill-me 和 grill-with-docs 。

工作方式

用户在一个 AI 代理（如 Claude Code、Codex）中调用某个技能（例如 /grill-me ）。

技能执行一系列步骤：向用户提问、分析输入、生成文档、修改代码或提交变更。

用户获得结果：对齐后的计划、精炼的术语表、更好的代码架构、测试用例、代码审查等。

你需要提供

一个支持技能调用的 AI 编码代理（如 Claude Code、Codex）。

每个仓库首次使用时，运行 /setup-matt-pocock-skills 进行配置：选择问题跟踪器（GitHub、Linear 或本地文件）、设置分类标签、指定文档保存位置。

根据具体技能，可能需要提供问题描述、代码文件、命令行反馈等。

你会获得

一套可复用的工程实践，帮助你和 AI 代理更高效地协作。

对计划进行深度对齐，避免误解。

共享的领域语言，减少代理的冗余输出。

测试驱动开发、代码审查、架构改进等流程的自动化执行。

持续改进的代码库质量。

使用示例

以下示例展示了共享语言的效果。来自 course-video-manager 仓库的 CONTEXT.md ：

之前 ："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"

这种简洁性在每次会话中都能节省大量 token。

选型说明

用户主动调用 的技能（如 /grill-me ）需要用户手动输入命令触发。

模型自动调用 的技能（如 /tdd ）可以由用户触发，也可以在任务匹配时由代理自动链接。

用户主动调用的技能可以调用模型自动调用的技能，但不会调用另一个用户主动调用的技能。

注意事项

本技能集需要配合 AI 编码代理使用，如 Claude Code 或 Codex。

建议在安装后先运行 /setup-matt-pocock-skills 完成配置。

技能文件是独立的，你可以根据自己的需求修改它们（如果通过 skills.sh 安装）。

本技能集不承诺任何特定的输出质量，实际效果取决于代理能力和你的使用方式。

试试这样做

• /grill-with-docs 我想在现有的项目中添加一个新的用户认证模块，请通过提问帮助我理清需求并建立相关的领域语言。
• /tdd 请引导我使用红绿重构循环（Red-Green-Refactor）来开发这个新的 API 端点，确保测试先行。
• /diagnosing-bugs 我遇到了一个难以复现的生产环境错误，请使用此技能引导我进行系统性的排查。

作者：Matt Pocock 开发者 / 职场人 ｜ GitHub Stars 189K ｜ 标签：编程开发 自动化 已认证 开源许可: MIT

来源：colaos.ai ｜ Skill ID：mattpocock-skills