Matt Pocock（Total TypeScript 作者）把自己每天做真实工程开发用的 agent 技能开源了，来源是他的 .agents 目录，不是演示用的 vibe coding 套件。设计哲学：小而灵活、可组合、与模型无关，鼓励 fork。

项目：mattpocock/skills。和 book-to-skill 互补：一个管知识沉淀，一个管工程纪律。

为什么不用大而全的流程框架

GSD、BMAD、Spec-Kit 一类方法会拥有整个流程：省事，但也夺走控制权，流程本身出 bug 很难查。Matt 的技能是纪律工具箱——你仍控制流程，技能只沉淀最佳实践。

安装（二选一）

方式 命令 特点
Claude Code 插件 claude plugins install mattpocock-skills 托管、只读、作者更新自动推送
skills.sh 拷贝 npx skills@latest add mattpocock/skills 文件进仓库，可改；npx skills update 手动更新

不要两个都装，会得到双份技能。

两类技能

  • User-invoked（用户调用）：你输入命令才触发（如 /grill-me），负责编排。可以调 model-invoked，不能再调另一个 user-invoked
  • Model-invoked（模型调用）：你可触发，任务匹配时 agent 也会自动用，承载可复用纪律

清单（工程）

用户调用

  • ask-matt：问当前该用哪个技能 / 流程
  • grill-with-docs：追问式访谈，构建领域模型，更新 CONTEXT.md / ADR
  • triage：用状态机让 issue 在角色间流转
  • improve-codebase-architecture：扫描深化机会，输出 HTML 报告
  • setup-matt-pocock-skills：每个仓库跑一次的配置
  • to-spec：把当前对话收成 spec，发到 issue tracker
  • to-tickets：拆成 tracer-bullet ticket，声明阻塞边界
  • implement：按 spec 实现，接缝处走 /tdd，提交前 /code-review
  • wayfinder：超大工作量拆成调查 ticket 地图

模型调用

  • prototype：一次性原型回答设计问题
  • diagnosing-bugs：reproduce → minimise → hypothesise → instrument → fix → regression-test
  • research：高信任一手来源调研，带引用写入仓库
  • tdd：红—绿—重构，一次一个垂直切片
  • domain-modeling：打磨领域模型，压力测试术语
  • codebase-design：深模块纪律（小接口、大量行为、可经接口测试）
  • code-review：Standards（规范 + Fowler 坏味道）与 Spec（是否忠实实现）双轴，并行子 agent
  • resolving-merge-conflicts：按意图逐 hunk 处理，不 --abort

清单（生产力）

  • grill-me：对计划 / 设计持续追问，直到决策树分支都关掉（Matt 最受欢迎的技能之一）
  • handoff：把对话压成交接文档
  • teach：跨会话教一个概念，当前目录当工作区
  • writing-great-skills：怎么写好 skill
  • grilling：grill-me / grill-with-docs 背后的追问循环

四个工程痛点

1. 对齐

最常见失败是错位：你以为对方懂了，做出来完全不是。AI 时代是你和 agent 之间的沟通鸿沟。开始前用 /grill-me 或 /grill-with-docs 把要建的东西问清楚。

2. 共享语言

DDD 里的 ubiquitous language。agent 空降项目只能猜黑话。用 CONTEXT.md 沉淀术语。

例如：

  • 改前：「课程某个 section 里的 lesson 被设为 real（文件系统里有了位置）时会有问题」
  • 改后：「materialization cascade 有问题」

命名一致后，代码更好找，agent 也更省 token。

3. 反馈回路

没有「代码实际怎么跑」的反馈，agent 就是盲飞。静态类型、浏览器、自动化测试；关键是先写失败测试再修。配套 /tdd、/diagnosing-bugs。

4. 设计关怀

Agent 加速编码，也加速软件熵。动手前 /to-spec 确认碰哪些模块；代码库变泥球时跑 /improve-codebase-architecture（建议隔几天一次）。

评价

  • 不是流程框架，是可单独取用的纪律
  • user-invoked 编排 + model-invoked 纪律分得干净
  • tracer-bullet ticket、ADR 内联、冲突按意图解决，都是真工程里的硬功夫
  • 想学怎么写 skill，先读 writing-great-skills

和 book-to-skill 一起看：输入侧把书变成可查资产，过程侧把实践变成可复用工作流，都走开放的 Agent Skills 标准。

快来参与讨论吧~