第 14 期 · 2026-11-14
mattpocock/skills — 一套每天真实在用的 Agent Skills
本期是每日一仓第 14 期,主角是 mattpocock/skills:TypeScript 教育者 Matt Pocock(Total TypeScript、aihero.dev 作者)放在自己 .agents 目录里、每天真实在用的 Agent Skills 合集。昨天第 13 期的 obra/superpowers 也是技能仓库,两期连着排在榜单前列,说明 2026 年的 Agent Skills 正在从零散的提示词拼贴,变成一类正式的工程资产。
一句话定位
一套小而可组合、模型无关的 Agent Skills:39 个技能覆盖从需求对齐、写规格、拆任务、TDD 实现、代码评审到发 PR 的完整工程链路,装进 Claude Code、Codex、Copilot、Gemini CLI 都能用,核心理念是给 Agent 立规矩、而不是替人接管流程。
源码结构
实测是 2026-11-14 浅克隆(git clone --depth 1)的结果:检出 212 个文件、1.8 MB。仓库几乎不含传统意义上的代码,内容本身就是 Markdown 技能,GitHub 把它的主要语言标为 Shell 只是检测口径所致。
skills/(624 KB):39 个SKILL.md,共 4,672 行 Markdown,另有 72 个配套 Markdown 文件。按五个桶组织:engineering/20 个(日常代码工作)、productivity/7 个(通用流程)、in-progress/8 个(公开测试版)、misc/4 个(冻结保留)、deprecated/只剩一篇说明。docs/(324 KB):28 篇面向人类读者的技能说明页,与skills/的两个正式桶镜像,每篇固定四段:这是什么、什么时候用、常见问题、怎么算生效,发布在 aihero.dev/skills-技能名。.agents/(40 KB):仓库的治理文档,包括两份 ADR、安装说明块、调用规则与写文档规范。.claude-plugin/:plugin.json与marketplace.json,插件只发 27 个正式技能(20 个工程类加 7 个生产力类),in-progress与misc不进插件。scripts/(12 KB):link-skills.sh、list-skills.sh,以及一个 Node 脚本sync-plugin-version.mjs。.changeset/、.github/、.out-of-scope/:分别是 changesets 发布流、三个 GitHub Actions 工作流(needs-info、release、triage-label)与 9 份否决记录。- 根目录:
README.md258 行、CHANGELOG.md374 行、CLAUDE.md、SCOPE.md、GLOSSARY.md、CONTRIBUTING.md、package.json。package.json里只有两个 dev 依赖(@changesets/cli与@changesets/changelog-github),版本号 1.3.2,CHANGELOG 记了 9 个版本。
架构图
flowchart TD
U[用户敲斜杠命令] --> R[ask-matt 路由]
R --> G[grill-with-docs 对齐访谈]
G --> P[prototype 验证想法]
G --> S[to-spec 写规格]
S --> T[to-tickets 拆分任务]
T --> I[implement 并行实现]
I --> C[code-review 双轴评审]
C --> PR[pr 写 PR 描述]
G --> D[domain-modeling 共享语言]
D --> GL[GLOSSARY 与 ADR 落盘]
I --> TD[tdd 红绿重构]
I --> DB[diagnosing-bugs 诊断环]
SU[setup-matt-pocock-skills] --> GL
SU --> TR[Issue Tracker 与 Triage 标签]
G --> GR[grilling 访谈原语]
分层设计说明
这套技能是按一条主流程加两层底座组织的。主流程是 ask-matt 画的路线图:想法先过 grill-with-docs 的访谈对齐,需要可运行的答案就绕道 prototype,再经 to-spec 写规格、to-tickets 拆成带阻塞边的任务、implement 或 implement-spec 并行实现,最后 code-review 与 pr 收尾。ask-matt 本身是个路由器技能,规则写明:讲一个技能是干什么之前,先读它的 SKILL.md,不许凭自己的一行摘要下结论。
底座分两层。一层是词汇层:domain-modeling 与 codebase-design 提供模块、接口、深浅、缝隙、适配器这些共享词,grill-with-docs 在访谈中把项目术语沉淀进 GLOSSARY.md,把难解释的决策写成 ADR。二层是落地层:setup-matt-pocock-skills 每个仓库只跑一次,问清 Issue Tracker 用哪家、triage 标签怎么打、文档放哪里,然后把这些约定写进仓库的 docs/agents/ 里,技能从此按这套约定工作,而不是每次现问。
分发层同样分层:Claude Code 走官方插件市场自动更新,Codex 与 Copilot 走仓库自带的 marketplace,Gemini CLI 与其他 Agent 用 skills.sh 或 npx skills 拷可编辑副本,本地开发则用 scripts/link-skills.sh 把技能目录软链进 ~/.claude/skills 与 ~/.agents/skills,一次 git pull 即完成更新。
技术亮点
亮点一:编排层极薄,原语可复用。 最能说明这套设计的是 grill-me 这个技能:整个 SKILL.md 除 frontmatter 外只有一句话,“Call the Skill tool with grilling”。访谈本身是 grilling 这个模型可调用的原语,grill-me、grill-with-docs、triage、wayfinder、improve-codebase-architecture 五个用户调用技能都复用它,区别只在访谈之外附加什么:grill-with-docs 附加写术语表与 ADR,wayfinder 附加决策票。证据是实测的 39 个技能里有 24 个标了 disable-model-invocation: true(只能由用户敲命令触发),其余 15 个是模型可自主调用的原语;编排与原语的边界由 frontmatter 一个字段划清,而不是靠文档约定。代价是原语必须足够通用,grilling 的访谈规则要同时服务五种场景,改一处影响五处。
亮点二:反馈环是硬编码的,不是建议。 tdd 技能的核心不是“先写测试”,而是“只在预先商定的缝隙上写测试”:动手前先写下公共边界、和用户确认每个缝隙能抓住什么、漏掉什么,未确认的缝隙上不许写测试。diagnosing-bugs 更进一步,把诊断做成六阶段门控循环:先造出能稳定复现 bug 的反馈环,再缩小范围、提假设、插桩、修复、补回归测试;1.3.2 的 CHANGELOG 记了一处修复,第 5 阶段现在要求先对强制变异做 diff,确认改动真的让测试变红,防止“改了等于没改却通过了”的假红。code-review 则是双轴并行评审:标准轴与规格轴各跑一个子 Agent,互不污染,再合并报告。这些机制的共同点是把“好习惯”写成检查点,而不是写进建议清单。边界也很清楚:反馈环的质量取决于缝隙选得对不对,选错缝隙,测试写得再规范也测不到点子上。
亮点三:技能自带治理,拒绝清单与发布流都是仓库的一部分。 SCOPE.md 给新想法设了两条准入线:必须有真实会话里观察到的失败(附上跑了什么、技能做了什么、预期是什么),且符合仓库哲学;光是“觉得更好”的假设不受理。9 份 .out-of-scope/ 文件把否决掉的概念与理由逐条存档,新技能提案直接关闭,理由是“能由现有技能组合出的行为不配拥有新技能”。配套的是 changesets 发布流:改动先写 changeset,npm run version 汇总进 CHANGELOG,再由 sync-plugin-version.mjs 把版本号同步进 plugin.json,保证插件版本与包版本不错位。misc/ 桶被冻结且所有 issue 直接关闭,in-progress/ 桶公开征求反馈但不进插件、不配文档页、随时可变可删。这种治理的代价是贡献门槛高,外部想加技能基本只能 fork。
值得参考的设计或实现
- 技能即文件,元数据即契约。 每个技能就是一个目录加
SKILL.md,frontmatter 只放name、description与是否禁模型调用;agents/openai.yaml再补各 harness 的展示信息。想给自己团队做一套技能,不用先搭框架,先按这个目录约定写 Markdown 就能跑。 - 薄编排、厚原语。 用户命令只做路由与收尾,真正的规则沉淀在可复用的原语里;这也是
grill-me只有一行的原因。自己写技能时,先问“这段规则会不会被第二个命令用到”,会就抽成原语。 - 先对齐再动手,并且留下纸面痕迹。
grill-with-docs的访谈产物不是聊天记录,而是落进仓库的GLOSSARY.md与 ADR;下一次会话直接读这些文件,不用重新对齐。README 里举的例子很直观:把“课程里一个小节被变成真实文件”统一叫“物化级联”,之后变量名、文件名与 Agent 的表述都用同一个词,Agent 的啰嗦与 token 消耗同时下降。 - 用安装器把约定写进仓库。
setup-matt-pocock-skills不是文档,而是一个会提问并写文件的技能:它把 Issue Tracker、triage 标签、文档位置这些约定一次性写进docs/agents/,之后所有技能按同一份约定工作。团队规范最难的是“每次都一样”,把它变成安装步骤比写进手册可靠。 - 把文风也写进仓库规范。
CLAUDE.md明文规定全仓库 prose 不许用破折号,遇到就改写成逗号、冒号或括号;派发子 Agent 必须用全新上下文窗口(Codex 默认 fork 父会话会继承上下文,正好违背子 Agent 存在的目的)。这类细节看起来琐碎,但它们是“技能在任何人手里行为一致”的来源。 - 否决清单比功能清单更能定方向。
.out-of-scope/的 9 份文件记录了不做什么与为什么,比 README 更能说明这个仓库的边界。
适合谁
每天用 Claude Code、Codex、Copilot 或 Gemini CLI 写真实工程代码、而不是一次性生成 demo 的人;觉得 GSD、BMAD、Spec-Kit 这类重框架接管过多、想要小而可改的流程的人;以及想给自己的 Agent 团队立一套可安装、可版本化、可治理的技能的人。不适合只想找个“一键生成整个应用”方案的人,这个仓库的立场恰恰相反:流程的控制权留在人手里。
怎么上手
按 Agent 选一种安装方式,插件会自动更新;其他 Agent 用 npx skills@latest add mattpocock/skills 拷可编辑副本,安装时记得勾上 setup-matt-pocock-skills。然后在每个仓库里跑一次 /setup-matt-pocock-skills,回答 Issue Tracker、triage 标签与文档位置三个问题。之后的工作流从 /grill-with-docs 开始:先把想法聊透、把术语写进 GLOSSARY.md,再走 to-spec、to-tickets、implement、code-review。想尝鲜的 8 个 in-progress 技能不在插件里,用 npx skills@latest add mattpocock/skills --skill=<名字> 单独装。本地开发调试可跑 scripts/link-skills.sh,技能以软链形式进 ~/.claude/skills,改完 git pull 就生效。
数据卡
- 仓库:mattpocock/skills
- Star:323,809(Atlas 快照 2026-11-02 为 306,916,12 天涨了 16,893,约每天 1,400)
- Fork:27,174
- 主要语言:Shell(GitHub 检测口径;实际内容为 125 个 Markdown 文件、8,358 行,另有 5 个 Shell 脚本与 1 个 Node 脚本)
- 许可证:MIT
- Atlas 分类:Skills;领域:软件开发
- 创建时间:2026-02-03;最近更新:2026-11-13
- 当前版本:1.3.2;官网:https://aihero.dev/skills