AI技能工具集

项目概述

Skills For Real Engineers 是一套面向 AI 编码代理（Claude Code、Codex 等）的工程实践技能集合。它主张小型、可适配、可组合的设计理念，反对 GSD、BMAD、Spec-Kit 等“接管整个流程”的方案——后者虽然简化了开发过程，却剥夺了工程师的控制权，使得流程中的 Bug 难以定位与修复。

这套技能基于数十年工程经验提炼而成，可与任意模型配合使用，既能整批订阅使用，也支持按需修改。

安装方式

提供了两种安装哲学，请选择其一（同时安装会导致技能重复）：

Claude Code 插件方式

将整套技能作为只读包安装，作者发布更新后自动同步。命令如下：

claude plugins install mattpocock-skills

或在会话内执行 /plugin install mattpocock-skills。插件来自 Claude Code 官方市场，无需额外配置。

skills.sh 方式

将可编辑的技能文件复制到项目目录中，便于深度定制：

npx skills@latest add mattpocock/skills

安装器会提示选择需要的技能以及目标代理；务必勾选 setup-matt-pocock-skills。后续可通过 npx skills update 拉取更新。Codex 原生插件已在路线图上。

初始化

在代理中执行 /setup-matt-pocock-skills，每个仓库只需运行一次。它会询问：

• 使用的 Issue 跟踪器（GitHub、Linear 或本地文件）
• Triage 阶段使用的标签（/triage 会依赖标签分类）
• 生成文档的存放位置

设计动机

作者总结了使用 AI 编码代理时最常见的四类失败模式，并针对每一类提供了对应的技能：

1. 代理未按预期执行

最常见的失败原因是人机沟通错位。解法是在动手前进行“审问式对话”，让代理主动追问细节。对应技能：

• /grill-me：用于非编码场景
• /grill-with-docs：在 grill-me 基础上叠加共享语言与 ADR 文档产出

2. 代理输出过于冗长

代理常因不熟悉项目术语而用 20 个词描述本可 1 个词概括的概念。解法是建立项目的 CONTEXT.md 共享语言文档，沉淀领域术语。这同样集成在 /grill-with-docs 中。共享语言还能带来额外收益：命名一致、代码更易导航、代理消耗的 token 更少。

3. 代码无法运行

对齐目标后，代理仍可能产出低质量代码。根本原因是缺乏反馈循环——静态类型、浏览器访问、自动化测试缺一不可。核心实践是红绿重构循环：

• /tdd：在任何项目中接入测试驱动开发流程
• /diagnosing-bugs：将调试最佳实践封装为分阶段、门控式的诊断循环

4. 代码库沦为“泥球”

代理加速编码的同时也加速了软件熵增。解法是重视代码设计：

• /to-spec：在生成规格前先确认涉及的模块
• /improve-codebase-architecture：扫描代码库寻找“可深化”的模块候选并生成可视化 HTML 报告，建议每隔几天运行一次。它只做勘察，不做清理。

技能参考

技能按调用方划分为两类：用户调用型（仅通过 /命令 手动触发，负责编排）和模型调用型（可被用户或代理在场景匹配时自动调用，承载可复用的工程纪律）。

工程类（Engineering）

用户调用型：ask-matt（技能路由）、grill-with-docs（带领域建模的审问）、triage（Issue 状态机流转）、improve-codebase-architecture（架构深化勘察）、setup-matt-pocock-skills（初始化配置）、to-spec（对话转规格）、to-tickets（拆解为追踪子弹票）、implement（驱动 /tdd 与 /code-review 完成实现）、wayfinder（规划超大工作量，拆为决策票逐步攻克）。

模型调用型：prototype（原型验证）、diagnosing-bugs（结构化调试）、research（带引用的研究文档）、tdd（红绿重构）、domain-modeling（打磨领域模型）、codebase-design（深模块设计纪律）、code-review（双维度代码评审，含 Fowler 坏味道基线）、resolving-merge-conflicts（按意图解决合并/变基冲突）、wizard（生成人工操作向导脚本）。

生产力类（Productivity）

用户调用型：grill-me（无代码场景的深度审问）、handoff（对话压缩为交接文档）、teach（多会话教学）、to-questionnaire（异步问卷）、wait-what（当消息未理解时触发重述）。

模型调用型：grilling（可复用的审问原语，被 grill-me、grill-with-docs、triage、wayfinder、improve-codebase-architecture 共用）、writing-for-agents（面向代理编写文档的规范）。