快速开始
npx skills add mattpocock/skills --skill=setup-matt-pocock-skillsnpx skills update setup-matt-pocock-skills功能说明
setup-matt-pocock-skills 教会一个代码仓库如何让工程类技能在其内部正确运作——包括问题(issue)存放在哪里、分类标签叫什么名字、领域文档放在什么位置——并将这些答案记录为配置,供其他技能读取。
它写入的是配置,而不是硬编码行为。工程链假设 docs/agents/ 目录下存在三个文件;这个技能就是一次性引导工具,负责从你的实际代码仓库中(通过 git remote、现有标签、现有 CONTEXT.md)发现这些信息,并经你确认后生成这些文件,而不是凭空猜测。它由提示驱动——先探索、展示发现、确认、再写入——而非确定性的脚手架工具。
何时使用
你通过输入 /setup-matt-pocock-skills 来调用它——智能体不会主动使用它。
在每个代码仓库中,在使用任何其他工程类技能之前,使用一次即可。如果 triage、to-spec 或 to-tickets 开始猜测你的问题存放在哪里,或者应用不存在的标签,说明它们还没有在此处完成设置。只有在需要切换问题追踪器或重新开始时才重新运行它——日常的微调只需要编辑 docs/agents/*.md 即可。
三项决策
每一项都会先给出一个建议答案,你可以一键接受,并且会跳过所有已经能推断出的内容——所以大多数运行只需要几次快速确认:
- 问题追踪器——工作在哪里被追踪,这样
triage/to-spec/to-tickets就知道是调用gh、glab、在.scratch/下写入 markdown,还是遵循你描述的工作流。支持 GitHub、GitLab、本地 markdown 或其他。(它会根据你的git remote提出匹配的方案。)
- 分类标签——只有在
triage技能已安装时才会询问,而且只问一句:保留默认标签(needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix)吗?只有当你的追踪器已经使用了其他名称时才说不,这样triage会应用真实的标签而不会创建重复项。
- 领域文档——默认假定为单上下文(根目录下有一个
CONTEXT.md+docs/adr/),这适用于几乎所有的代码仓库;只有在检测到 monorepo 信号时,它才会提出多上下文映射的配置。
输出是在 docs/agents/ 下生成一组文件——issue-tracker.md、domain.md,以及当 triage 已安装时的 triage-labels.md——并在代码仓库已使用的 CLAUDE.md 或 AGENTS.md 中添加一个指向这些文件的 ## Agent skills 区块。这些文件是整个工具包所依赖的共享基础。
成功的标志
issue-tracker.md和domain.md出现在docs/agents/下(以及当triage已安装时的triage-labels.md),并且## Agent skills章节出现在你的CLAUDE.md或AGENTS.md中。
- 它提出的追踪器与你的真实
git remote匹配,标签与你代码仓库中已有的字符串匹配。
- 之后,
triage和to-tickets会在正确的位置使用正确的标签进行操作,而不再需要询问或猜测。
在整个流程中的位置
setup-matt-pocock-skills 是一次性设置——是整个工程技能集的基础,而不是需要重复执行的步骤。与之相邻的技能是那些读取它所写入内容的技能:triage,因为它应用这里配置的标签词汇;以及 to-spec 和 to-tickets,因为它们将内容发布到此处配置的问题追踪器中。首先运行它;所有下游技能都假设它已经运行过了。当你不确定哪个技能或流程适合时,可以找 ask-matt 帮你导航。