#Matt Pocock Skills 实战教程

Matt Pocock Skills 是 TypeScript 生态知名讲师 Matt Pocock 每日自用的 agent skills 集合，口号是 "Skills For Real Engineers"——给真正做工程的人用，而不是"氛围编码"（vibe coding）。

与 GSD、BMAD、Spec-Kit 这类"接管整个流程"的方法论不同，Matt 的设计哲学是：

• 小而可组合——每个 skill 只做一件事，可以自由拼装
• 可适配——不锁定流程，随你改造
• 与模型无关——任何 agent 都能用（Claude Code、Codex、Pi 等）

本教程把仓库里的 36 个 skills 逐个拆解成独立文档，先讲安装与配置，再讲核心工作流地图，然后按五个分类逐篇实战。

#安装教程

两种安装方式，对应两种哲学，二选一即可（都装会每个 skill 出现两份）：

#方式一：Claude Code 插件（订阅式）

插件在 Claude Code 官方市场里，安装后作为只读捆绑包管理，作者更新时自动同步——你订阅而不是 fork：

claude plugins install mattpocock-skills

或者在会话内：

/plugin install mattpocock-skills

#方式二：npx skills CLI（复制式）

把 skill 文件复制进你的仓库，成为你能自由编辑的普通文件。没有后台自动更新，想同步时手动执行 npx skills update：

npx skills@latest add mattpocock/skills

安装器会让你挑选要安装哪些 skills、装到哪些 agent 上。务必勾选 setup-matt-pocock-skills——它是整套技能的初始化向导。

#验证安装

装完后新开一个会话，对 agent 说：

> 现在有哪些 mattpocock 的 skills 可用？

能看到 /ask-matt、/triage、tdd、code-review 等技能即安装成功。也可以直接运行初始化：

/setup-matt-pocock-skills

#更新

# 插件方式：自动更新，无需手动操作
claude plugins update mattpocock-skills

# 复制方式：手动拉取最新改动
npx skills update

#配置：运行初始化向导

每个仓库运行一次 /setup-matt-pocock-skills，它配置工程技能依赖的三件事：

1. Issue 追踪器（GitHub / GitLab / 本地 Markdown / 自定义）→ 写入 docs/agents/issue-tracker.md
2. Triage 标签词汇（五个规范角色：needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix）→ 写入 docs/agents/triage-labels.md
3. 领域文档布局（单上下文 CONTEXT.md + docs/adr/，或 monorepo 多上下文 CONTEXT-MAP.md）→ 写入 docs/agents/domain.md

并把 ## Agent skills 小节加入 CLAUDE.md 或 AGENTS.md（优先编辑已存在的那个）。

#核心工作流地图

Matt 的 36 个技能不是平铺的，而是一张地图。主流程是大多数工作的路径——从想法到交付：

/grill-with-docs（访谈打磨想法，留下 CONTEXT.md 和 ADR）
        │
        ├─ 需要可运行的答案？ → /handoff → /prototype → /handoff 回来
        │
        ├─ 跨多个会话的大工程？ → /to-spec → /to-tickets → 逐个 /implement
        │
        └─ 单会话能搞定？ → 直接 /implement
                                   │
                                   ├─ 内部驱动 /tdd（一次一个垂直切片）
                                   └─ 提交前跑 /code-review（双轴审查）

上匝道（产生工作后汇入主流程）：/triage（bug 堆积）、diagnosing-bugs（东西坏了）、/wayfinder（巨大模糊项目）。

代码健康：/improve-codebase-architecture（扫描深化机会）。底层词汇：domain-modeling（领域语言）、codebase-design（深层模块词汇）。

#上下文卫生

步骤 1–3 保持在一个不中断的上下文窗口里（到 /to-tickets 之前不要 compact 或 clear），让访谈、规格和票据建立在同一套思考上。每个 /implement 再从票据出发、用全新上下文开始——每张票据自包含，上一张的上下文可以丢弃。

如果会话接近智能区（state-of-the-art 模型约 150k token，超过后推理质量下降）还没到 /to-tickets，别硬撑：在最近的阶段边界 /compact 后继续。

#全部技能索引

#🏗️ 工程技能（9 个，用户调用）

#🛠️ 工程工具（9 个，模型触发）

#⚙️ 生产力技能（7 个）

#🧰 工程杂项（4 个）

#🧪 实验性技能（7 个，beta）

#实战组合示例

#场景一：接到一个模糊的新需求

> 我们想做一个"团队周报自动汇总"功能，帮我理清思路

1. /grill-with-docs — 把需求访谈成清晰决策，领域术语写入 CONTEXT.md
2. /to-spec — 对话直接合成为规格，发布到 issue 追踪器
3. /to-tickets — 拆成垂直切片票据，标注阻塞关系
4. 逐个 /implement — 每张票据内部驱动 tdd，提交前跑 code-review

#场景二：bug 堆积、架构变差

> 最近 issue 堆了一堆 bug，而且代码越来越难改

1. /triage — 把外部 bug 报告分类、验证、写成 agent brief
2. diagnosing-bugs — 处理最难的那个 bug（先建红色反馈循环）
3. /improve-codebase-architecture — 扫描架构深化机会，HTML 报告里挑一个
4. codebase-design — 设计选中模块的深层接口

#场景三：全新的大项目，路线不清

> 我们要从零做一个数据平台，工作量巨大，先从规划开始

1. /wayfinder — 画一张决策票据地图，逐张解决直到路线清晰
2. 地图清晰后交给 /to-spec 塌缩成可构建计划
3. 再走 /to-tickets → /implement 主流程