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。

工作方式

1. 用户在一个 AI 代理（如 Claude Code、Codex）中调用某个技能（例如 /grill-me）。
2. 技能执行一系列步骤：向用户提问、分析输入、生成文档、修改代码或提交变更。
3. 用户获得结果：对齐后的计划、精炼的术语表、更好的代码架构、测试用例、代码审查等。

你需要提供

• 一个支持技能调用的 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 安装）。
• 本技能集不承诺任何特定的输出质量，实际效果取决于代理能力和你的使用方式。