- 发布日期
Agent 做错、太啰嗦、代码变泥球：用 mattpocock/skills 对齐再动手
Agent 交付总跑偏时：用可组合工程 Skills 做对齐、TDD、排障与架构扫描，并在装完后用一次真实流程验证。
Agent 总跑偏时，先别继续 vibe
mattpocock/skills 来自 Matt Pocock 日常使用的 .agents 目录：把软件工程基本功收成可复用、可组合、可改写的 Skill。目标不是更快糊代码，而是减少「做出来不对 / 太啰嗦 / 不可维护」。
你卡住时为什么需要它
- 开工前没对齐，做完才发现不是那个需求
- Agent 输出又长又空，项目术语不统一
- 缺测试与诊断闭环，修一个出两个
- 模块边界腐烂，越改越怕
这套 Skills 覆盖上述失败模式，适合作为基础设施模块的工程底座。
设计原则
- 小而可改编：每个 Skill 足够小，方便按项目裁剪
- 可组合：用户触发型 Skill 可编排模型触发型 Skill
- 模型无关：不绑定单一模型或单一 Agent 产品
- 保留控制权：不像 GSD / BMAD / Spec-Kit 那样接管整个流程
快速安装
Claude Code Plugin
claude plugins install mattpocock-skills
或在会话内：
/plugin install mattpocock-skills
Plugin 走官方 marketplace，更新会自动同步。
skills.sh / 其他 Agent
npx skills@latest add mattpocock/skills
安装时可选 Skill 与目标 Agent。建议务必勾选 setup-matt-pocock-skills。
对喜欢本地改写的人，同一条命令会把 Skill 文件写入仓库，之后可用：
npx skills update
按需拉取上游更新。
首次配置
安装后在 Agent 中执行一次：
/setup-matt-pocock-skills
它会询问：
- 使用的 issue tracker（GitHub / Linear / 本地文件）
- triage 时使用的 label
- 文档落盘位置
它要解决的四类失败
1. Agent 没按你的意思做
用 grilling 强制对齐：
/grill-me：通用对齐访谈/grill-with-docs：对齐的同时沉淀领域语言与 ADR
2. Agent 太啰嗦
通过共享语言（如 CONTEXT.md）统一术语，让 Agent 用项目自己的词说话，减少无效 token。
3. 代码不正确
补齐反馈环：
/tdd：红-绿-重构/diagnosing-bugs：复现 → 缩小 → 假设 → 埋点 → 修复 → 回归
4. 代码变成泥球
用设计意识对抗熵增：
/to-spec：写 spec 前先问清触及哪些模块/improve-codebase-architecture：定期扫描可深化的模块边界
技能速览
Engineering（用户触发）
| Skill | 作用 |
|---|---|
ask-matt | 路由：帮你选该用哪条流程 |
grill-with-docs | 对齐 + 领域模型 / ADR |
triage | 按状态机流转 issue |
improve-codebase-architecture | 架构深化机会扫描 |
setup-matt-pocock-skills | 仓库级一次性配置 |
to-spec | 把当前对话沉淀为 spec |
to-tickets | 拆成 tracer-bullet tickets |
implement | 按 spec/tickets 实现并收尾 review |
wayfinder | 超大任务的调查地图规划 |
Engineering（模型可触发）
| Skill | 作用 |
|---|---|
prototype | 用可运行原型回答设计问题 |
diagnosing-bugs | 纪律化排障循环 |
research | 高可信来源调研并落盘 |
tdd | 测试驱动开发 |
domain-modeling | 持续打磨领域模型 |
codebase-design | 深模块设计纪律 |
code-review | Standards + Spec 双轴审查 |
resolving-merge-conflicts | 按意图解决合并冲突 |
Productivity
grill-me/grilling：决策树式对齐访谈handoff：把当前会话压缩成交接文档teach：跨会话教学工作区writing-great-skills：编写高质量 Skill 的原则
在本站中的定位
在 AI 应用开发 → 基础设施 → Skills 下，mattpocock/skills 是工程向底座：对齐、测试、诊断、架构与交付。可与 Site Skills 组合使用。
你现在可以做的下一步
- 安装并执行一次
/setup-matt-pocock-skills。 - 用真实需求跑通
/grill-me或/tdd其中一条。 - 成功判据：你能指出「对齐产物落在哪」或「红-绿-重构实际发生过」。