mattpocock/skills · 上手攻略
- 仓库：mattpocock/skills
- 链接：https://github.com/mattpocock/skills
- 分类：Agent Skill · Engineering
- 作者：Jay
- 更新：2026-08-04
是什么
mattpocock/skills 是 Matt Pocock（TypeScript 教学者、 前 Vercel 工程师）将自己的 .agents 目录公开的仓库，收录他在日常真实工程中使用的 Agent 技能。这些技能面向真实软件开发，而非 vibe coding，核心理念是：小型、易适配、可组合；基于数十年工程经验，适用于任何模型。
仓库规模极大（Stars 201144），是 Agent Skill 领域的标杆仓库之一。
解决什么问题
Matt Pocock 在 README 中直击痛点：GSD、BMAD、Spec-Kit 等 Agent 开发方法论在"接管过程"的同时，也剥夺了你的控制权，且 Agent 产出 bug 时难以排查。
这个仓库的思路正相反：把具体工程实践（对齐、TDD、代码审查、领域建模）拆成独立技能，让 Agent 在你定义的规则下工作。你始终拥有控制权，Agent 只是执行者。
快速安装
方式一：Claude Code 插件（推荐）
Claude Code 官方插件市场，一键安装，自动更新：
# 命令行安装
claude plugins install mattpocock-skills
# 或在 Claude Code 会话内
/plugin install mattpocock-skills
这是只读托管安装，技能随作者更新自动同步，适合只想用的用户。
方式二：可编辑安装（通过 skills.sh）
npx skills@latest add mattpocock/skills
选择你需要的技能，installer 会将技能文件写入你的项目仓库，你可以自由修改。更新时：
npx skills update
⚠️ 不要同时安装两种方式，否则技能会重复加载。
方式三：其他 Coding Agent（Codex 等）
同样使用 npx skills@latest add mattpocock/skills，installer 支持多种 Agent 目标。
核心技能详解
用户触发型技能（User-Invoked）
这些技能需要你手动输入命令触发：
| 技能 | 用途 |
|---|---|
/grill-me |
需求对齐：对 Agent 进行"拷问式访谈"，在动手前把需求彻底澄清 |
/grill-with-docs |
在对齐基础上，生成项目共享语言（Ubiquitous Language），更新 CONTEXT.md 和 ADR |
/triage |
按状态机处理 issue：从 Triage → Ready → In Progress → Done |
/to-spec |
将当前对话合成一份 spec，直接发布到 issue tracker |
/to-tickets |
将 plan/spec 分解为 tracer-bullet tickets，写入本地文件或真实 tracker |
/implement |
按 spec 构建，驱动 /tdd 在预设边界，并在 commit 前执行 /code-review |
/wayfinder |
规划超大任务（超出单次会话容量），在 tracker 上生成调查票，逐一解决直到路径清晰 |
/improve-codebase-architecture |
扫描代码库寻找深化机会，生成可视化 HTML 报告，然后逐一"烤问" |
/setup-matt-pocock-skills |
配置仓库：选择 issue tracker（GitHub/Linear/本地）、定义 triage 标签、设置文档保存路径 |
模型触发型技能（Model-Invoked）
Agent 可在合适时机自动调用的技能：
| 技能 | 用途 |
|---|---|
/tdd |
红-绿-重构循环，先写失败测试，再实现代码 |
/diagnosing-bugs |
严格诊断循环：复现 → 最小化 → 假设 → 探测 → 修复 → 回归测试 |
/code-review |
两轴审查：Standards（代码规范 + Fowler smell）+ Spec（是否忠实实现原始需求），并行子 agent 运行避免互相污染 |
/domain-modeling |
主动构建项目领域模型，对照 glossary 检验术语，用边界场景压力测试，更新 CONTEXT.md 和 ADR |
/codebase-design |
共享的模块设计纪律：深模块、小接口、干净边界、可通过接口测试 |
/prototype |
快速构建一次性原型来回答设计问题（终端 App 测逻辑，或多个 UI 变体） |
/research |
调查问题并引用高可信度一手源，结果写入带引用的 Markdown 文件，作为后台 agent 运行 |
/resolving-merge-conflicts |
逐 hunk 处理 in-progress git merge/rebase 冲突，追溯意图后解决，最后完成操作（永不 --abort） |
典型适用场景
- 大型复杂项目kickoff：先用
/grill-with-docs建立共享语言，避免 Agent 用 20 个词描述 1 个概念 - TDD 驱动开发：每次写功能前调
/tdd，强制先写测试 - 代码库健康维护：每隔几天跑一次
/improve-codebase-architecture，防止 entropy 失控 - Bug 攻坚：使用
/diagnosing-bugs的结构化诊断循环，而非盲目试错 - Code Review：在
/implement完成后自动触发/code-review，确保代码符合规范 - 多 Agent 协作：用
/handoff将当前上下文压缩成交接文档，交给下一个 agent
坑与注意
- 不要同时用两种安装方式：插件安装是只读的，skills.sh 安装是可编辑的。装两遍 = 技能加载两次，行为混乱。
/grill-with-docs是核心：Matt 认为这是仓库里最酷的技能——它同时做需求对齐 AND 建设共享语言，产出 CONTEXT.md（领域术语表）和 ADR（架构决策记录），一举多得。setup-matt-pocock-skills必须先跑一次：在使用其他工程技能前，需要先配置 issue tracker 和 triage 标签，否则/triage等技能不知道你的工作流长什么样。- CONTEXT.md 不是CLAUDE.md：这是领域术语表（Ubiquitous Language），不是项目概述。Agent 学会这些术语后，沟通会极度简洁。
/tdd的边界定义很重要：在调用/implement前，你和 Agent 应该事先约定 TDD 的边界（即在哪里跑测试、用什么测试框架），否则 Agent 不知道测试写在哪里。- Codex 插件尚在路线图上：README 提到原生 Codex 插件在开发中，当前需要通过
npx skills@latest安装。
与同类对比
| 仓库 | 定位 | 规模 | 特色 |
|---|---|---|---|
mattpocock/skills |
代码工程实践 | 201k ⭐ | TDD/grill/architecture 完整工程环 |
davidondrej/skills |
Agent 编排 + 研究 | 3.2k ⭐ | 多 Agent 协同、DeepAPI 研究 |
anthropics/skills |
学术写作 | 166k ⭐ | 论文写作、科研 Agent 技能 |
addyosmani/agent-skills |
生产工程 | 81k ⭐ | Google 工程师出品、生产级标准 |
核心差异：Matt Pocock 的技能是面向工程师自己的工程纪律，强调人对 Agent 的控制；其他仓库更多是面向 Agent 的任务能力扩展。
一句话推荐结论
如果你想让 Agent 在代码工程中遵循 TDD、代码审查、领域建模等真实工程纪律，同时保留你对项目结构和规则的控制权，mattpocock/skills 是目前最完整、最可操作的方案；建议从 /grill-with-docs 开始体验其精髓。
原始仓库：https://github.com/mattpocock/skills