解读：mattpocock/skills——给真工程用的 Agent Skills，不是 vibe coding 流程绑架

#Matt Pocock
#Skills
#Claude Code
#Agent
#工程实践
#开源
#解读

本文是对开源项目 mattpocock/skills（副标题 Skills For Real Engineers）的摘要与评论。抓取时仓库约 ★303754、forks≈25550；许可证 MIT；语言以 Shell/Markdown skills 为主。插图为 GitHub 社交预览；安装与完整 skill 列表以仓库 README 与 skills.sh 页为准。

这篇在说什么

作者 Matt Pocock（Total TypeScript / AI Hero 一线）把自己每天在用的 agent skills开源：刻意做成小、可改、可组合，强调「真工程」而不是把流程整包交给 GSD / BMAD / Spec-Kit 一类「替你拥有过程」的框架——那些框架常带走控制权，流程里的 bug 也难排。

定位一句话：对齐 → 共享语言 → 反馈环 → 日常关心设计，用一组 slash skill 固化，而不是再发明一个重型方法论产品。和本站 prompts.chat 那种「通用提示词图书馆」不同：这边补的是需求对齐、测试、架构等工程纪律，并且假设你愿意对 Agent 追问与验收。

针对的四种 Agent 翻车

README 用四类失败模式组织技能（大量引用《Pragmatic Programmer》、DDD、XP、Ousterhout）：

没做成我想要的 → 先「烤问」（grilling）：/grill-me、/grill-with-docs（烤问同时长领域词表与 ADR）。
话太多、术语对不齐 → 项目级共享语言（如 GLOSSARY.md），让一句行话代替二十词描述。
代码根本不行 → 反馈环：类型、浏览器、自动化测试；/tdd 红绿重构；/diagnosing-bugs 分阶段诊断。
建成大泥球 → Agent 加速编码也加速熵增；/to-spec、/improve-codebase-architecture（定期巡检「加深模块」机会，是勘察不是一键拆泥球）。

解读：这不是「提示词合集」，而是把经典工程纪律可调用化。和本站另文 AI Design Skills（补视觉/落地页规范）也不同：设计向合集管「长得对不对」，这边管「需求清不清、测没测、架构会不会塌」。

怎么装（极简）

官方提醒：插件会自更新；skills.sh 则是拷可编辑文件进项目、自己改、自己更新——两边装会技能翻倍，选一种即可。

Claude Code：claude plugin install mattpocock-skills@claude-plugins-official
Codex / Copilot：走各自 marketplace（见 README）
其他（含 Cursor）：npx skills@latest add mattpocock/skills -a <agent>

装完后每个仓库跑一次 /setup-matt-pocock-skills：选 issue 跟踪器、triage 标签、文档落盘位置。不跑 setup，后面的烤问与工单流很容易空转——技能假设项目里已经有「约定放哪」的答案。

技能地图（不必一次全上）

技能按谁能触发分两类：

User-invoked：你敲才进（编排用），如 ask-matt、grill-with-docs、triage、to-spec、to-tickets、implement / implement-spec、wayfinder、retro、improve-codebase-architecture。
Model-invoked：你可手动，也可由 Agent 在匹配任务时自动够——如 tdd、diagnosing-bugs、domain-modeling、code-review、prototype、research、pr、wizard。

Productivity 侧还有通用的 grill-me、handoff、teach、wait-what 等。规则是：user-invoked 可以调 model-invoked，不要再调另一个 user-invoked，以免编排套娃。

解读：日常最小闭环往往是——改动前 /grill-with-docs → /to-spec 或 /to-tickets → /implement（内部走 TDD）→ /code-review；每隔几天再跑一次架构巡检。你不必一次启用全部技能；先把「烤问 + 规格 + 实现」跑顺，通常就比「丢一句做完整个功能」稳得多。

谁适合、谁会觉得吵

适合已经愿意对 Agent 追问与验收的人：你承认模型会写得快，也承认它会偏题、漏测、把模块糊成泥。不适合只想要「一键生成整站」且拒绝维护 glossary / ADR 的用法——skills 多、心智负担不小；不跑 setup、不维护共享语言，烤问也会空转。

星标爆炸说明市场饿「可复制的 Agent 工程习惯」，而不只是更长的 system prompt。代价是学习曲线：你要理解 user-invoked 与 model-invoked 的分工，还要接受「技能是可改的源文件」，而不是黑盒流程产品。若你要的是视觉与落地页规范，去看设计向合集更对口；若你要的是通用角色卡，去看 prompts.chat。这边站在中间偏工程的那一层。

完整列表与更新以仓库为准；想跟更新可看作者 newsletter（README 入口）。把 skills 当「可版本管理的工程习惯」，而不是「又一份神秘提示词」，会更好用。

完整能力表与最新变更仍以仓库 README 为准；本文只做摘要与评论。