setup-matt-pocock-skills - 工程技能仓库配置

技能概述

setup-matt-pocock-skills 是一个一次性运行的仓库初始化技能，在第一次使用其他工程技能之前跑一遍，把 issue 跟踪器、triage 标签词汇表和领域文档布局这三件事在仓库里配置好。

适用场景

1. 首次接入 Matt Pocock 工程技能包：刚安装 to-tickets、triage、to-spec 这类技能，需要先让它们知道这个仓库的 issue 存在哪里、标签叫什么、文档放在哪，否则后续技能无从下手。
2. 新仓库或新项目起步：仓库里还没有 docs/agents/、没有 CONTEXT.md，希望一次性把 AI 代理需要的工作约定落成文件，而不是每次对话都重新解释一遍。
3. 多包 monorepo 需要分上下文管理：仓库存在 pnpm-workspace.yaml、packages/* 这类信号时，技能会提出多上下文布局（根 CONTEXT-MAP.md 指向各子包的 CONTEXT.md），而不是把整套文档硬塞进单一上下文。

核心功能

1. 配置 issue 跟踪器：先探索仓库现状（git remote -v、.git/config），再据此推荐跟踪器类型——GitHub 用 gh CLI、GitLab 用 glab CLI、无远端或单人项目可用 .scratch/<feature>/ 下的本地 markdown，也支持 Jira、Linear 等自定义流程。最终结论写入 docs/agents/issue-tracker.md。
2. 配置 triage 标签词汇表：只有在 triage 技能已安装时才会执行。默认沿用五个规范角色——needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix，标签字符串与角色名一致；若你的跟踪器已在使用别的命名（比如用 bug:triage 表示 needs-triage），可以改成映射到现有标签，避免创建重复标签。
3. 配置领域文档布局并写入代理约定：默认采用单上下文布局（根目录一个 CONTEXT.md 加 docs/adr/），只有探索到 monorepo 信号时才提供多上下文选项。确定后在 CLAUDE.md 或 AGENTS.md 中写入 ## Agent skills 区块，为每个配置面留一行摘要加文件指引。

整个流程是 prompt 驱动而非确定性脚本：技能会先探索、把发现摊开给你看、逐节确认，然后才落盘。确认阶段会先给出草稿供你修改。若所选文件里已存在 ## Agent skills 区块，则原地更新内容，不会追加重复块，也不会覆盖你对其他章节的改动。

常见问题

这个技能需要运行几次？什么时候跑？

正常情况下每个仓库只跑一次，位置是在第一次使用其他工程技能之前。之后如果只是想微调内容，直接编辑 docs/agents/*.md 即可，不需要重跑；只有当你打算更换 issue 跟踪器、或者想从头重新配置时，才需要再运行一次。

会自动创建 AGENTS.md 吗？已有的 CLAUDE.md 会被覆盖吗？

都不会。文件选择有明确规则：CLAUDE.md 存在就编辑它，否则编辑 AGENTS.md，两者都不存在时会先问你要创建哪一个，不会替你决定。技能也绝不会在 CLAUDE.md 已存在的情况下去新建 AGENTS.md，反之亦然。写入时只更新 ## Agent skills 区块，周边章节保持原样。

不用 GitHub 能用吗？没有远端仓库怎么办？

可以。GitHub 只是默认推荐项，实际上支持 GitLab（走 glab CLI）、本地 markdown（issue 以文件形式放在 .scratch/<feature>/ 下，适合单人项目或无远端仓库）、以及 Jira、Linear 等其他跟踪器——选"其他"时只需用一段话描述你的工作流，技能会把它作为自由文本记录下来。另外要注意这个技能设置了 disable-model-invocation: true，只能由你手动触发，AI 不会自行调用它。