用AI提升代码质量与架构设计
mattpocock-skills
把工程流程拆成小而可改的 skill：拷问需求、转成工单、TDD 施工、排查疑难 bug。
试试这样做
/grill-with-docs 我想在现有的项目中添加一个新的用户认证模块，请通过提问帮助我理清需求并建立相关的领域语言。
/tdd 请引导我使用红绿重构循环（Red-Green-Refactor）来开发这个新的 API 端点，确保测试先行。
/diagnosing-bugs 我遇到了一个难以复现的生产环境错误，请使用此技能引导我进行系统性的排查。
详细介绍
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安装）。 - 本技能集不承诺任何特定的输出质量，实际效果取决于代理能力和你的使用方式。