给真工程师用的 AI Agent 技能集，不是 vibe coding
更新于 2026-09-19
← 返回汇总把数十年工程经验，压缩成可组合的 AI Agent 技能
Matt Pocock（Total TypeScript 作者）日常使用的 Agent 技能集。与 GSD/BMAD/Spec-Kit 这些「接管流程」的方案不同——这些技能小、易改、可组合，不夺走你的控制权，适用于任何模型。核心理念：软件工程基本功（对齐、共享语言、反馈循环、架构设计）在 AI 时代比以往更重要。19 万 stars，AI 编程工程化赛道的标杆。
Claude Code 官方 marketplace 上架 · npx skills.sh 跨 Agent 安装
最常见：对齐失败。你以为 Agent 懂了，做出来全错。解法：grilling 会话——动手前让 Agent 反复盘问你。
项目黑话 Agent 不懂，20 个词说 1 个能说完的。解法：共享语言（ubiquitous language），沉淀进 CONTEXT.md。
没有反馈循环，Agent 盲飞。解法：TDD 红-绿-重构循环 + 结构化诊断。
Agent 加速编码也加速熵增，代码库飞速腐化。解法：深度模块设计，每几天跑一次架构改进。
GSD/BMAD 想拥有整个流程，出了 bug 难修。这些技能只做一件事，组合权在你。
User-invoked（你手动敲，负责编排）与 Model-invoked（Agent 自动触发，承载可复用纪律）。前者可调后者，绝不调同类。
基于 Markdown + Shell，任何遵循 SKILL.md 约定的 Agent 都能用（Claude Code / Codex / 其他）。
绝大多数工作走这条路：你有个想法，想把它建出来。
| 步骤 | Skill | 做什么 | 调用类型 |
|---|---|---|---|
| ① | grill-with-docs | 盘问式打磨想法，同时建领域词表（写 CONTEXT.md + ADR） | user |
| ② | to-spec | 把对话综合成 spec（PRD），发布到 issue tracker，标 ready-for-agent | user |
| ③ | to-tickets | 拆成 tracer-bullet 垂直切片票，每张声明阻塞边 | user |
| ④ | implement | 按 spec/票构建，内部驱动 tdd，收尾跑 code-review | user |
① ② ③ 须在同一未中断的上下文窗口完成，④每张票起新窗口。临近 smart zone（~120k token）上限先 handoff。
触发：外来 issue/PR 堆积。做：把原始 issue 过状态机（needs-triage → ready-for-agent 等），产出 Agent 可用的 brief。
→ 汇入：implement 接手 ready-for-agent 的票
触发：东西坏了、难复现的 bug。做：复现→最小化→假设→插桩→修→回归测试，拒绝空想。
→ 汇入：post-mortem 交给 improve-codebase-architecture
触发：超大雾区（绿地项目/巨型特性），一个 session 装不下。做：在 tracker 上画决策票地图，一次解一张。
→ 汇入：雾散后 交接到 to-spec 收拢成计划（不直接 build）
不独立成流程，而是被上层 skill 调用，各自是某套词汇的唯一真相源。
盘问原语。grill-me 与 grill-with-docs 都跑它。逐个问题追问，直到决策树每个分支都解决。
领域语言纪律。挑战模糊术语、解决一词多义、把难逆转决策记成 ADR。维护 CONTEXT.md 词表。
深度模块词汇（module/interface/depth/seam/adapter）。tdd 与 improve-codebase-architecture 都用它。
| Skill | 类型 | 何时用 |
|---|---|---|
handoff | 跨会话 | 上下文将满/要分支（如进 prototype session），压缩成 markdown，新窗口引用它 |
prototype | 独立 | 设计问题纸面难定（状态模型对不对、UI 该长啥样），造抛弃式原型验证，留答案删代码 |
research | 独立 | 需读外部文档/API，委托后台 Agent对一手资料调研，产出带引用的 markdown，喂回主线 |
grill-me | 独立 | 无代码库时的盘问（grill-with-docs 的无状态版），不落 CONTEXT.md |
teach | 独立 | 跨多会话学新概念，用当前目录做有状态教学工作区 |
writing-great-skills | 独立 | 写/改技能的参考——让 skill 可预测的词汇与原则 |
空闲时跑。扫描代码库找「加深机会」，出可视化 HTML 报告，挑一个 grill。选中即生成 idea，带回主线 grill-with-docs。
它是调查；codebase-design 是设计台。
逐 hunk 解决进行中的 merge/rebase 冲突，按每方原始来源的意图解，绝不 --abort。
跑其他工程技能前，每仓库跑一次。配置后续技能都依赖的三样东西。
claude plugins install mattpocock-skills
# 或会话内
/plugin install mattpocock-skills
官方 marketplace，只读 bundle，我更新你自动跟。
npx skills@latest add mattpocock/skills # 选要的 skill + 装到哪个 agent # 务必带上 setup-matt-pocock-skills
技能文件写进你仓库，你拥有、可改。npx skills update 拉新版。
二选一，都装会每个 skill 出现两份。
19 万 stars 证明 AI 工程化纪律是刚需。与 Spec-Kit/BMAD 的「接管流程」路线相反，小而可组合的哲学更可持续。ask-matt 这套「技能间路由」设计是 Agent 技能组织的范本，影响深远。