📊 页面导航

    适用角色与上手难度

    角色推荐度上手难度
    🛠️ 开发★★★★★★☆☆☆☆
    🧪 测试★★★★☆★☆☆☆☆
    📦 产品★★★☆☆★★☆☆☆

    🎯 学习产出： 掌握 Matt Pocock Skills 的仓库级初始化配置，能独立完成 issue 追踪器、标签和领域文档的设置

    🚀 AI 能力提升： 工程配置

    /setup-matt-pocock-skills

    预计阅读时间: 4 分钟

    前置配置技能。在每个仓库运行一次，为其它工程技能铺设假设的配置。这是一个提示驱动的技能，不是确定性脚本：探索 → 展示发现 → 与用户确认 → 写入。

    概述

    工程技能（triage、to-tickets、to-spec、code-review、wayfinder 等）依赖三样配置，本技能把它们全部搭好：

    1. Issue 追踪器：issue 存在哪里
    2. Triage 标签词汇：五个规范分类角色用的实际标签字符串
    3. 领域文档布局：CONTEXT.md 和 ADR 放哪里、怎么读

    日常使用

    /setup-matt-pocock-skills

    实战

    1. 探索仓库现状

    读取但不假设：git remote -v（是不是 GitHub 仓库）、根目录有没有 AGENTS.md/CLAUDE.md 和已有的 ## Agent skills 小节、CONTEXT.md/CONTEXT-MAP.md、docs/adr/、docs/agents/、.scratch/、triage 是否已安装、monorepo 信号（pnpm-workspace.yaml、workspaces 字段）。

    2. 逐节确认（一节一问，给出推荐答案）

    A 节：Issue 追踪器。

    选项说明使用 CLI
    GitHubissue 存仓库的 GitHub Issues（默认推荐）gh
    GitLabissue 存仓库的 GitLab Issuesglab
    本地 Markdownissue 是 .scratch/<feature>/ 下的文件无
    其他Jira、Linear 等——描述一段工作流即可记录自定义

    GitHub/GitLab 模板带一个"PR 作为请求面"开关，默认关闭，不要主动开启。

    B 节：Triage 标签词汇（仅当 triage 已安装）。

    默认标签就是五个角色名：needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix。只有当追踪器已用别的名字时才收集覆盖映射。

    C 节：领域文档布局。

    默认单上下文：根目录一个 CONTEXT.md + docs/adr/，几乎适配所有仓库，直接写不用问。只有检测到 monorepo 信号才提供多上下文选项（根 CONTEXT-MAP.md 指向各包的 CONTEXT.md）。

    3. 确认并写入

    展示草稿让用户编辑：

    • 加入 CLAUDE.md 或 AGENTS.md 的 ## Agent skills 块（优先编辑已存在的那个，绝不新建另一个；已有块就原地更新不追加重复）
    ## Agent skills

### Issue tracker

[where issues are tracked 一行摘要]. See `docs/agents/issue-tracker.md`.

### Triage labels

[label vocabulary 一行摘要]. See `docs/agents/triage-labels.md`.

### Domain docs

[layout 一行摘要: "single-context" or "multi-context"]. See `docs/agents/domain.md`.
    • 三个文档文件（按种子模板）：docs/agents/issue-tracker.md、docs/agents/triage-labels.md（仅装 triage 时）、docs/agents/domain.md

    4. 完成

    告诉用户配置完成、哪些技能会读这些文件。以后可以直接编辑 docs/agents/*.md；只有想换追踪器或从头再来才需要重跑本技能。

    与其它技能的关系

    • 前置条件：triage、to-spec、to-tickets、code-review、wayfinder 都在缺少配置时提示"请运行 /setup-matt-pocock-skills"
    • 产物：docs/agents/*.md 三个文件是工程技能的单一事实来源