什么是 setup-matt-pocock-skills？
如果你用过 Matt Pocock 的任何一个技能——比如 grill-with-docs、tdd、improve-codebase-architecture——你可能会遇到一个情况：技能用起来总觉得差点意思。AI 不知道你的 issue 存在哪里，不知道你们团队用什么标签来分类工单，也不知道你习惯把文档放在哪个目录。
这不是技能本身的问题。这些技能都依赖一套每个仓库的本地配置——工单系统在哪里、分类标签用什么词、领域文档放什么位置。但这些配置没人帮你装。
setup-matt-pocock-skills 就是来补这个缺的。它的官方定位只有一句话：在每个仓库运行一次，然后再使用其他 engineering skills。
它不教你怎么写 issue、怎么 triage，它只做一件事：把三个核心配置决策问清楚，然后落地成文件，让后面所有的 engineering skills 都有一个确定的读写位置。
主要功能
1. 它不是脚本，是一次对话
第一次看到这个 skill 的人容易把它当成脚手架，以为运行一次就自动生成一堆配置文件。官方文档专门纠正了这一点：It writes config, it does not hard-code behaviour（它写配置，不硬编码行为）。
区别在哪？脚手架是确定性的：输入参数，吐出模板。setup 是 prompt-driven 的：先探索仓库的真实状态，把发现摆给你看，每个问题都带推荐答案，你确认后它才写入。能推断出来的它直接跳过，不废话。
所以整个 skill 的运作逻辑是一段对话，不是一个脚本。对话的起点也不在模板里，而在仓库本身的真实状态：git remote -v、.git/config、AGENTS.md 和 CLAUDE.md 是否存在、CONTEXT.md、.scratch/ 目录、monorepo 信号。这些探测结果决定了它接下来问什么、怎么推荐。
2. 三个核心配置决策
setup-matt-pocock-skills 会依次带你过三个决策，每次只问一个，等你回答完再进入下一个：
Section A - Issue Tracker（工单系统） ：你的 issue 存在哪里？to-tickets、triage、to-prd、qa 等技能需要知道是调用 gh issue create、在 .scratch/ 下写 markdown 文件，还是走你描述的其他工作流。默认优先推荐 GitHub（如果 git remote 指向 GitHub），也支持 GitLab 和本地 markdown。
Section B - Triage Labels（分类标签） ：你 triage 工单时用什么标签？/triage 技能依赖这套标签词汇来运作。
Section C - Domain Docs（领域文档） ：CONTEXT.md 和 ADR 放在哪里？以及读取它们的规则是什么。
3. 只由你主动触发
这个 skill 只能由你主动触发。输入 /setup-matt-pocock-skills，agent 才会跑。它不会在你调用别的 skill 时偷偷自动执行。这是 Matt Pocock 整套设计里 “user-invoked 而非 model-invoked” 哲学的一部分。
4. 能推断的绝不问
setup 会先做一圈侦察——看 remote、看现有配置文件、看目录结构——然后把已经确定的信息直接填上，只把真正需要你做决策的问题抛出来。每个问题都带一个推荐答案，你只需要说“同意”或者“改成别的”。
如何安装和运行 setup-matt-pocock-skills
第一步：安装技能包
在终端中执行以下命令：
npx skills@latest add mattpocock/skills安装器会列出所有可选的技能让你选择。务必确保选中 setup-matt-pocock-skills。如果漏选了，后面所有 engineering skills 都会因为缺少配置而无法正常工作。
第二步：运行配置
在你的 AI 编程助手（Claude Code、Cursor、Codex 等）中，输入：
/setup-matt-pocock-skills
第三步：回答三个问题
AI 会依次问你三个配置决策——工单系统、分类标签、文档位置。每个问题都带推荐答案，你确认或修改即可。
第四步：开始使用其他技能
配置完成后，grill-with-docs、tdd、improve-codebase-architecture、to-issues、triage 等所有 engineering skills 就都有了确定的读写位置。
应用场景
场景一：新项目初始化
你刚用 npx skills add mattpocock/skills 装完一整套 Matt Pocock 的技能，准备开始用。但你发现 grill-with-docs 不知道你的 issue 存在哪里，triage 不知道你们用什么标签。跑一次 /setup-matt-pocock-skills，把三个配置问清楚，后面的技能才能正常运转。
场景二：接手一个已有仓库
你刚加入一个新团队，clone 下一个有历史的仓库。仓库用 GitHub Issues 管理工单，但里面既没有 AGENTS.md 也没有 CLAUDE.md。你想让这套 engineering 流程全部跑起来，但不知道从哪开始。运行 /setup-matt-pocock-skills，AI 会先侦察仓库的现状，然后带你把缺失的配置补齐。
场景三：团队统一配置
团队里有 5 个人都在用 Matt Pocock 的技能，但每个人的配置都不一样——有人用 GitHub Issues，有人用 Linear，有人把文档放在 docs/，有人放在 doc/。这让协作变得混乱。统一跑一遍 setup，把配置写进仓库的 AGENTS.md 或 CLAUDE.md，所有人都用同一套配置。
场景四：切换工单系统
你的团队从 GitHub Issues 换到了 Linear，或者从 Linear 换回了 GitHub。所有依赖工单系统的技能（to-issues、triage、to-prd、qa）都需要更新配置。重新跑一次 /setup-matt-pocock-skills，告诉 AI 新的工单系统是什么，配置自动更新。
◯ 评论 0