[Agent 技能] Matt Pocock's Skills：面向严谨工程实践的 Agent 技能集

本条目基于官方仓库 mattpocock/skills v1.2.3 版本进行梳理与收录。

一、 框架定位与设计概述

Matt Pocock’s Skills 是由 TypeScript 工程师 Matt Pocock（Total TypeScript）开源的模块化 Agent 技能套件。

与全流程强管控的重型框架不同，它将传统软件工程中沉淀的经典实践（如测试驱动开发、领域驱动设计、深度模块封装与代码坏味道排查）拆解为 25 个独立、可按需选配且易于调整的 SKILL.md 技能定义。

整个体系在触发机制上分为两层：

• 用户显式指令（User-invoked）：以 / 开头（如 /grill-with-docs、/implement），由开发者在会话中主动输入以发起流程或编排任务。
• 模型自主调用（Model-invoked）：无 / 前缀（如 tdd、diagnosing-bugs、code-review），由 Agent 在执行任务时根据实际场景自主判断并调用。

二、 核心问题与治理目标

该技能集主要针对 Agent 在日常编码中容易出现的四类失控状态提供治理方案：

• 需求理解走样：通过多轮反向提问（Grilling）在动工前摸清交互细节与异常边界，避免因理解模糊导致推倒重来。
• 术语混乱与上下文消耗：通过在项目中维护统一的领域词典（CONTEXT.md），用精准术语替代冗长的背景解释，降低沟通摩擦与 Token 消耗。
• 生成代码难以稳定运行：依托 TDD（红灯-绿灯-重构）与结构化排错规程，为模型提供即时验证反馈。
• 架构退化成混乱泥球：推行深度模块设计（简单接口封装复杂逻辑），并定期静态扫描代码库，寻找可以下沉封装的模块候选，抑制快速编码带来的软件熵增。

三、 安装配置与工程工作流

1. 安装与初始化

推荐使用 skills-cli 将全部技能以通用模式安装到当前项目：

npx skills add mattpocock/skills -a universal

安装完成后，在目标项目内执行一次初始化指令：

/setup-matt-pocock-skills

该指令会引导确认三项基础配置：工单系统类型（GitHub Issues、Linear 或本地文件）、分拣任务时使用的标签命名，以及生成文档的保存目录。Claude Code 等支持插件市场的环境亦可直接通过原生插件途径加载。

2. 标准工程交付流水线

在实际开发一项新功能或进行复杂重构时，推荐按以下 5 个阶段流转：

1. 需求拷问与术语沉淀（/grill-with-docs）
   动工前对开发者进行多轮反向提问，梳理设计边界，并将专有名词与架构决策同步写入领域词典（CONTEXT.md）与 ADR 文档。
2. 规范固化与任务拆解（/to-spec $\to$ /to-tickets / /wayfinder）
   将讨论共识一键整理为结构化需求规范，并拆解为带有依赖关系的原子任务卡；超大型工程则可使用 /wayfinder 构建决策依赖拓扑。
3. 测试驱动编码实现（/implement）
   驱动 Agent 读取任务卡分步编写代码，并在关键实现节点串联底层的 tdd 技能，严格遵守红绿测试循环。
4. 双轴审查与代码提交（code-review）
   由两个独立的审查子 Agent 分别检查代码规范（坏味道基线）与需求一致性（是否忠实还原工单），确认无误后完成提交；若遇合并冲突可调用 resolving-merge-conflicts。
5. 定期架构巡检与重构（/improve-codebase-architecture）
   定期静态扫描代码库的复杂度与模块深度，生成可视化的 HTML 诊断报告，辅助开发者开展针对性的架构重构。

四、 核心技能资产索引

官方仓库共包含 25 项核心技能，按功能领域划分如下：

1. 工程开发类（Engineering · 18 项）

• 需求澄清、领域建模与架构治理：
  • /grill-with-docs（用户指令）：动手前多轮反向提问澄清需求，同步更新领域词典（CONTEXT.md）与架构决策记录（ADR）。
  • domain-modeling（模型自调）：在对话中主动提炼业务专属术语，用统一语言消除上下文歧义。
  • codebase-design（模型自调）：遵循深度模块设计原则，通过小接口封装复杂逻辑并保证可测试性。
  • /improve-codebase-architecture（用户指令）：静态扫描代码库的模块深度，生成可视化 HTML 诊断报告以供重构。
• 任务规划与工单流转：
  • /to-spec（用户指令）：将对话共识整理成结构化需求规范并同步到工单系统。
  • /to-tickets（用户指令）：把规范或讨论切解为一组带有前置依赖的原子任务卡。
  • /wayfinder（用户指令）：面向超大型工程，在工单系统中建立决策依赖地图并按拓扑顺序推进。
  • /triage（用户指令）：按照状态机规则在工单系统中流转和分拣 Issue。
  • /ask-matt（用户指令）：技能路由器，根据开发者当前遇到的场景推荐最合适的技能与流程。
• 编码实现、质量守门与协作：
  • /implement（用户指令）：依据任务卡驱动代码实现，串联底层 TDD 并闭环代码审查。
  • tdd（模型自调）：测试驱动开发，按红灯测试 $\to$ 绿灯通过 $\to$ 重构优化的节奏编写代码。
  • diagnosing-bugs（模型自调）：针对疑难 Bug 的六步诊断循环，涵盖复现测试、假设验证、埋点插桩与脱敏保护。
  • code-review（模型自调）：双轴并行代码审查，分别检查代码规范（坏味道基线）与需求还原度。
  • resolving-merge-conflicts（模型自调）：逐块分析 Git 冲突，追溯两侧分支提交意图并化解冲突。
  • wizard（模型自调）：生成交互式 Shell 引导脚本，协助人类完成云资源配置、密钥填写或数据迁移。
• 原型探索与技术调研：
  • prototype（模型自调）：快速构建单文件 HTML 原型或在同路由下构建多套可选 UI 方案。
  • research（模型自调）：让后台子 Agent 针对可信一手资料开展调研并输出引证书目 Markdown 备忘录。
  • /setup-matt-pocock-skills（用户指令）：项目级一次性初始化配置工具。

2. 流程与效能类（Productivity · 7 项）

• /grill-me（用户指令）：纯逻辑与方案层面的反向提问，不涉及代码，专用于理清思路。
• grilling（模型自调）：底层的通用追问引擎，驱动多个技能的提问逻辑。
• /handoff（用户指令）：将当前会话的核心决策与进展浓缩为交接文档，便于在新会话中恢复上下文。
• /wait-what（用户指令）：在 Agent 输出过于抽象时，命令其结合项目词汇表用直白语言重新解释。
• /to-questionnaire（用户指令）：将技术分歧转换为 Markdown 调查问卷，方便异步发给相关人员收集反馈。
• /teach（用户指令）：以当前目录为互动练习沙盒，跨会话分步讲解复杂技术概念。
• writing-for-agents（模型自调）：规范为 Agent 编写文档（如技能定义与系统守则）的格式与标准。