setup-matt-pocock-skills

设置 Matt Pocock 的技能

搭建工程技能所依赖的仓库级配置：

• 问题跟踪器 — 问题存放的位置（默认使用 GitHub；开箱即支持本地 Markdown）
• 分类标签 — 用于五种规范分类角色的字符串
• 领域文档 — CONTEXT.md 和 ADR 的存放位置，以及使用者读取这些文档时应遵循的规则

这是一项由提示词驱动的技能，并非确定性脚本。先探索并展示发现，再与用户确认，然后写入配置。

流程

1. 探索

查看当前仓库，了解其初始状态。读取已有内容；不要想当然：

• git remote -v 和 .git/config — 这是 GitHub 仓库吗？具体是哪一个？
• 仓库根目录下的 AGENTS.md 和 CLAUDE.md — 是否存在其中任一文件？其中是否已有 ## Agent skills 部分？
• 仓库根目录下的 CONTEXT.md 和 CONTEXT-MAP.md
• docs/adr/ 和任何 src/*/docs/adr/ 目录
• docs/agents/ — 这项技能之前的输出是否已存在？
• .scratch/ — 表明是否已采用本地 Markdown 问题跟踪器约定

2. 展示发现并询问

总结已有内容和缺失内容。然后引导用户逐一作出三项决定——先展示一个部分，获取用户的回答，再进入下一项。不要一次性展示全部三项。

假设用户不了解这些术语。每个部分都先简短说明它是什么、这些技能为什么需要它，以及选择不同选项会带来什么变化。然后展示选项和默认值。

A 部分——问题跟踪工具。

说明：“问题跟踪工具”是这个仓库存放问题的地方。to-issues、triage、to-prd 和 qa 等技能会从中读取信息并写入内容——它们需要知道应调用 gh issue create、在 .scratch/ 下写入 Markdown 文件，还是遵循你描述的其他工作流。请选择你实际用来跟踪此仓库工作的地方。

默认建议：这些技能是为 GitHub 设计的。如果 git remote 指向 GitHub，建议选择 GitHub。如果 git remote 指向 GitLab（gitlab.com 或自托管主机），建议选择 GitLab。否则（或用户偏好其他选项时），提供以下选项：

• GitHub — 问题存放在仓库的 GitHub Issues 中（使用 gh CLI）
• GitLab — 问题存放在仓库的 GitLab Issues 中（使用 glab CLI）
• 本地 Markdown — 问题以文件形式存放在此仓库的 .scratch/<feature>/ 下（适合个人项目或没有远程仓库的项目）
• 其他（Jira、Linear 等）— 请用户用一段话描述工作流；技能会将其记录为自由格式的说明

B 部分——分类标签词汇表。

说明：triage 技能处理新收到的问题时，会通过状态机推进其状态——需要评估、等待报告者回复、已准备好由 AFK Agent 处理、已准备好由人工处理，或不会修复。为此，它需要应用与你实际配置的标签字符串相匹配的标签（或问题跟踪工具中的等效设置）。如果你的仓库已经使用不同的标签名称（例如 bug:triage 而不是 needs-triage），请在此处进行映射，这样技能就会应用正确的标签，而不是创建重复标签。

五种规范角色：

• needs-triage — 维护者需要评估
• needs-info — 等待报告者回复
• ready-for-agent — 规格完整，已准备好由 AFK Agent 处理（Agent 无需人工提供上下文即可接手）
• ready-for-human — 需要由人工实现
• wontfix — 不会处理

默认值：每种角色对应的字符串与其名称相同。询问用户是否希望覆盖其中任何一项。如果他们的问题跟踪工具没有现有标签，使用默认值即可。

C 部分——领域文档。

说明：一些技能（improve-codebase-architecture、diagnose、tdd）会读取 CONTEXT.md 文件，以了解项目的领域语言，并查阅 docs/adr/ 中过去的架构决策。它们需要知道仓库使用一个全局上下文，还是多个上下文（例如有独立前端和后端上下文的单体仓库），才能在正确的位置查找。

确认目录结构：

• 单一上下文 — 仓库根目录下有一个 CONTEXT.md 和 docs/adr/。大多数仓库都采用这种结构。
• 多上下文 — 根目录下有一个 CONTEXT-MAP.md，指向各个上下文对应的 CONTEXT.md 文件（通常用于单体仓库）。

3. 确认并编辑

向用户展示以下内容的草稿：

• 要添加到正在编辑的 CLAUDE.md / AGENTS.md 文件中的 ## Agent skills 区块（选择规则见步骤 4）
• docs/agents/issue-tracker.md、docs/agents/triage-labels.md、docs/agents/domain.md 的内容

写入前允许用户编辑。

4. 编写

选择要编辑的文件：

• 如果存在 CLAUDE.md，则编辑它。
• 否则，如果存在 AGENTS.md，则编辑它。
• 如果两者都不存在，请询问用户要创建哪个文件，不要替他们选择。

如果 CLAUDE.md 已存在，绝不要创建 AGENTS.md（反之亦然）——始终编辑已存在的文件。

如果所选文件中已经有 ## Agent skills 块，请就地更新其内容，不要追加重复内容。不要覆盖周围章节中的用户编辑内容。

该块：

## Agent skills

### Issue tracker

[one-line summary of where issues are tracked]. See `docs/agents/issue-tracker.md`.

### Triage labels

[one-line summary of the label vocabulary]. See `docs/agents/triage-labels.md`.

### Domain docs

[one-line summary of layout — "single-context" or "multi-context"]. See `docs/agents/domain.md`.

然后，以此技能文件夹中的种子模板为起点，编写以下 3 个文档文件：

• issue-tracker-github.md — GitHub 问题跟踪器
• issue-tracker-gitlab.md — GitLab 问题跟踪器
• issue-tracker-local.md — 本地 Markdown 问题跟踪器
• triage-labels.md — 标签映射
• domain.md — 领域文档使用规则与布局

对于“其他”问题跟踪器，根据用户的描述从头编写 docs/agents/issue-tracker.md。

5. 完成

告知用户设置已完成，并说明哪些工程技能现在会从这些文件读取信息。提醒他们之后可以直接编辑 docs/agents/*.md——只有在他们想要切换问题跟踪器或从头重新开始时，才需要再次运行此技能。