1. 先搞清楚 Matt Pocock skills 到底解决什么问题Matt Pocock skills 是一套给 AI 编码工具用的技能包不是浏览器插件也不是 npm 依赖库。它把「怎么让 AI 按工程纪律写代码」这件事拆成了 35 个可独立调用的技能覆盖从需求对齐、调研、写码、评审到交接的完整闭环。适合谁适合已经在用 Claude Code 或 Codex 做日常开发、但总觉得 AI 输出「差点意思」的人——比如它老是跳过测试直接改代码、评审时只挑格式不查逻辑、或者你根本不知道该让它先干什么。我自己的体感是没装 skills 之前Claude Code 像一个聪明但没规矩的实习生装完之后它更像一个知道「先建反馈环再动手」的工程搭档。核心差异在于技能分两种调用方式User-invoked你用/命令手动触发负责编排流程和 Model-invoked模型自动触发承载可复用纪律比如 tdd、code-review。仓库按skills/下四个桶组织engineering 18 个、productivity 7 个、in-progress 6 个beta、misc 4 个合计 35 个。这篇会交付三样东西可复制的安装命令、目录结构骨架、以及验证动作。同时说明怎么通过 TaoToken 统一 Key/API 通道完成工具侧配置让你不用在多个 Key 之间来回切换。2. TaoToken 前置统一 Key 与 API 通道在装 skills 之前先把模型通道理顺。Claude Code 和 Codex 各自需要配置 API 访问如果你同时用多个工具Key 管理会很乱。TaoToken 的作用是提供一个统一的 API 入口你只需要在工具侧填一次地址和 Key。官网地址https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_contentAPI 地址不加 UTMhttps://taotoken.net/api操作路径很简单先到控制台创建 API Key然后根据你用的工具选择对应的接入文档。Claude Code 走 Anthropic 兼容通道Codex 走标准 API 通道。具体入口模型对话验证模型是否通https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodel_chatutm_campaignrewriteCoding Plan长期编码/Agent 场景https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite控制台创建 Keyhttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewriteAPI Keys 管理https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewriteClaude Code Anthropic 配置https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_codeutm_campaignrewrite注意Key 只在创建时显示一次复制后存到安全的地方。不要提交到 Git 仓库。3. 可复制配置安装命令与目录结构3.1 Claude Code 插件安装只读、自动更新Claude Code 用户走插件通道装完自动跟随仓库更新claude plugins install mattpocock-skills或者在会话内直接执行/plugin install mattpocock-skills这种方式装的是只读副本你不需要手动维护作者更新后你这边自动同步。适合不想折腾、只想用稳定版的开发者。3.2 Codex / 其他 agent 安装可编辑副本如果你用 Codex 或其他支持 skills 协议的 agent走 npx 通道装的是可编辑副本可以勾选具体技能npx skillslatest add mattpocock/skills只装某个 beta 技能比如 loop-menpx skillslatest add mattpocock/skills --skillloop-me这种方式的好处是你可以改技能内容比如调整 tdd 的红-绿-重构节奏或者给 code-review 加自己的规范轴规则。3.3 每个仓库必跑的初始化装完技能后在 agent 中运行/setup-matt-pocock-skills这一步是每个仓库跑一次作用是选 issue 跟踪器、triage 标签、文档存放位置。后面的工程类技能比如 to-spec、to-tickets、implement都依赖这个初始化结果。跳过这步那些技能会找不到 issue tracker 配置。3.4 目录结构骨架装完之后你的项目根目录下会多出这些内容your-repo/ ├── .claude/ │ └── skills/ # Claude Code 插件技能只读 ├── .codex/ │ └── skills/ # Codex 技能副本可编辑 ├── CONTEXT.md # 领域模型文档grill-with-docs 维护 ├── docs/ │ └── adr/ # 架构决策记录 └── AGENTS.md # agent 行为约定CONTEXT.md和docs/adr/是 grill-with-docs 和 domain-modeling 技能会实时更新的文件。你不需要手动写但要知道它们的存在因为 code-review 的规格轴会读这些内容来判断「代码是否符合领域模型」。4. 验证请求与成功结果4.1 验证技能是否装好在 Claude Code 会话里输入/ask-matt如果装好了它会返回一个路由器式的响应告诉你当前场景该走哪条流程。如果报「command not found」说明插件没装成功回到 3.1 重装。4.2 验证初始化是否生效运行/setup-matt-pocock-skills成功的话它会问你 issue 跟踪器类型GitHub Issues / Linear / 其他、triage 标签名、文档存放路径。回答完后检查项目根目录是否生成了对应的配置文件。4.3 验证模型通道是否通在 Claude Code 里发一条简单请求比如「用一句话解释这个函数做什么」然后看返回。如果超时或报 401检查 TaoToken 的 Key 是否填对、API 地址是否用了https://taotoken.net/api。你也可以先到模型对话页面单独验证模型是否可用。4.4 验证 tdd 技能是否自动触发写一个简单函数然后让 Claude Code「给这个函数加测试」。如果 tdd 技能生效它会先写一个失败的测试红再写实现让它通过绿最后重构。如果它直接写实现再补测试说明 Model-invoked 没触发检查技能是否在.claude/skills/下。5. 本篇常见错排查5.1 装了插件但/ask-matt不识别最常见原因是 Claude Code 版本太旧不支持 plugins 命令。先升级到最新版再重装。另一个原因是你在错误的目录下执行——插件是全局的但/setup-matt-pocock-skills是每仓库一次别搞混。5.2 npx 安装报网络错误npx skillslatest需要访问 npm registry。如果你在公司内网检查 npm 代理配置。另外--skill参数后面的技能名必须和仓库里的目录名完全一致大小写敏感。写错了不会报错只是静默不装。5.3 初始化后 to-spec 还是找不到 issue tracker/setup-matt-pocock-skills的配置是写在项目本地的如果你换了分支或者 clone 了新仓库需要重新跑一次。另外如果你用的是 GitHub Issues确保ghCLI 已经登录否则技能无法创建 issue。5.4 code-review 只查格式不查逻辑code-review 是双轴的规范轴查格式和风格规格轴查是否符合 CONTEXT.md 里的领域模型。如果规格轴没生效大概率是 CONTEXT.md 为空或者不存在。先跑/grill-with-docs把领域模型建起来再跑 code-review。5.5 别去装的下架项以下技能已从仓库删除别再装deprecated/桶的 design-an-interface、qa、request-refactor-plan、ubiquitous-language以及 obsidian-vault硬编码作者私人 vault 路径有安全隐患。如果你在旧教程里看到这些名字跳过。5.6 常用推荐组合我按「普通开发者日常反复碰」的标准筛了 8 个覆盖「对齐 → 调研 → 写码 → 评审」闭环阶段技能作用地基/setup-matt-pocock-skills每仓库先跑入口/ask-matt不知道用啥就问它写码tdd红-绿-重构一次一个垂直切片评审code-review规范轴 规格轴并行查 bugdiagnosing-bugs建复现红的反馈环调研research prototype一手来源 一次性原型对齐/grill-me 或 /grill-with-docs需求没对齐时盘问收敛施工implement to-spec / to-tickets对话转 spec、拆工单、按单施工其余技能等遇到对应场景再装即可不必一开始全上。装太多反而会让模型在自动触发时选错技能。6. 长期编码与 Agent 场景的通道选择如果你主要用 Claude Code 做长期编码或者跑 Agent 任务建议走 Coding Plan 通道Key 和额度管理会更清晰。接入文档里有完整的配置示例包括环境变量写法和工具侧参数。Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewriteAPI Keyshttps://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite接入文档https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite最后说一个我踩过的坑skills 装完后不要急着把所有技能都打开。Model-invoked 技能是自动触发的装太多会导致模型在「该用 tdd 还是该用 prototype」之间犹豫。先装第 5.6 节那 8 个跑顺了再按需加。