首次使用 Matt Pocock 工程技能前：为仓库配置…

在仓库首次使用 Matt Pocock 工程技能前运行一次，生成该仓库的 issue tracker、triage labels 和 domain docs 配置。

适用场景

解决思路

1. 以 prompt-driven 方式执行：先探索仓库，展示发现，与用户确认，然后写入配置。
2. 探索当前 repo 并读取已有内容，不要假设；查看 `git remote -v` 和 `.git/config`，判断是否是 GitHub repo 以及具体是哪一个。
3. 检查 repo root 的 `AGENTS.md` 和 `CLAUDE.md` 是否存在，以及其中是否已有 `## Agent skills` section。
4. 检查 repo root 的 `CONTEXT.md` 和 `CONTEXT-MAP.md`。
5. 检查 `docs/adr/` 以及任何 `src/*/docs/adr/` directories。
6. 检查 `docs/agents/`，判断这个 skill 之前是否已经输出过内容。
7. 检查 `.scratch/`，判断是否已在使 local-markdown issue tracker 约定。
8. 检查是否已安装 `triage` skill（本 skill 旁边有 `triage` folder，或 available skills 中存在 `triage`），以决定 Section B 是否运行。
9. 检查 monorepo signals：`pnpm-workspace.yaml`、`package.json` 的 `workspaces` field，或已有内容且各自带 `src/` 的 `packages/*`；只有真正的大型 multi-package repo 才算；没有这些 signal 就是 single-context，几乎所有 repo 都如此。
10. 总结已有内容和缺失内容。
11. 按顺序处理 sections：每次一个 section、一个回答，再进入下一个。
12. 每个 section 都先给 recommended answer，让用户一个词就能接受；只有 choice 真正分叉时才给一行 explainer；exploration 已经确定答案时跳过整个 section（未安装 `triage` 时跳过 Section B；没有 monorepo 时跳过 Section C）。
13. Section A - Issue tracker：向用户解释 “issue tracker” 是这个 repo 存放 issues 的地方；`to-tickets`、`triage` 和 `to-spec` 等 skills 会从中读取并写入；它们需要知道是调用 `gh issue create`、在 `.scratch/` 下写 markdown 文件，还是遵循用户描述的其他工作流；让用户选择实际用于跟踪这个 repo 工作的位置。
14. Section A 默认姿态：这些 skills 是为 GitHub 设计的；如果 `git remote` 指向 GitHub，推荐 GitHub；如果 `git remote` 指向 GitLab（`gitlab.com` 或 self-hosted host），推荐 GitLab；否则（或用户偏好），提供以下选项。
15. Section A 选项 GitHub：issues 位于 repo 的 GitHub Issues（使用 `gh` CLI）。
16. Section A 选项 GitLab：issues 位于 repo 的 GitLab Issues（使用 `glab` CLI）。
17. Section A 选项 Local markdown：issues 作为文件位于本 repo 的 `.scratch/<feature>/` 下（适合个人项目或没有 remote 的 repos）。
18. Section A 选项 Other（Jira、Linear 等）：让用户用一段话描述工作流；skill 会把它记录为 freeform prose。
19. Section A 写入：把选择记录到 `docs/agents/issue-tracker.md`；GitHub 和 GitLab templates 带有 “PRs as a request surface” flag，默认 off；保持关闭且不要提问；想把 external PRs 放入 triage queue 的用户可以之后直接修改文件。
20. Section B - Triage label vocabulary：如果未安装 `triage`，完全跳过本 section；未安装的 skill 不需要 labels。
21. Section B 如果已安装 `triage`，只问一个问题：“是否保留默认 triage labels？（recommended: yes）”。
22. Section B 默认值是五个 canonical roles，label string 与 role name 相同：`needs-triage`、`needs-info`、`ready-for-agent`、`ready-for-human`、`wontfix`；回答 yes 就原样写入。
23. Section B 只有用户说 no（通常因为 tracker 已使用其他名称，例如用 `bug:triage` 表示 `needs-triage`）时，才收集 overrides，避免 `triage` 创建重复 labels。
24. Section C - Domain docs：默认 single-context：repo root 下一个 `CONTEXT.md` + `docs/adr/`；这适合几乎所有 repo，直接写入，无需提问。
25. Section C 只有 exploration 找到 monorepo signals 时，才提供 multi-context（root 下 `CONTEXT-MAP.md` 指向每个 context 的 `CONTEXT.md` files），并确认用户想要哪种 layout。
26. Confirm and edit：向用户展示草稿：要添加到 `CLAUDE.md` / `AGENTS.md` 的 `## Agent skills` block（选择规则见 step 4）。
27. Confirm and edit：展示 `docs/agents/issue-tracker.md`、`docs/agents/domain.md`，以及仅在安装了 `triage` 时才有的 `docs/agents/triage-labels.md` 内容。
28. Confirm and edit：写入前允许用户修改。
29. Write 选择要编辑的文件：如果 `CLAUDE.md` 存在，编辑它；否则如果 `AGENTS.md` 存在，编辑它；如果两者都不存在，询问用户要创建哪一个；不要替用户选择。
30. Write：当 `CLAUDE.md` 已存在时，绝不创建 `AGENTS.md`（反之亦然）；始终编辑已经存在的那个。
31. Write：如果所选文件已有 `## Agent skills` block，就原地更新其内容，而不是追加重复 block；不要覆盖周围 sections 的用户编辑。
32. Write block：写入以下 `## Agent skills` block： ## 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`.
33. Write：只有安装了 `triage` 且 Section B 实际运行时，才包含 `### Triage labels` sub-block 并写入 `docs/agents/triage-labels.md`；否则两者都省略。
34. Write：使用本 skill folder 中的 seed templates 作为起点写 docs files：`issue-tracker-github.md` - GitHub issue tracker；`issue-tracker-gitlab.md` - GitLab issue tracker；`issue-tracker-local.md` - local-markdown issue tracker；`triage-labels.md` - label mapping（仅当安装了 `triage`）；`domain.md` - domain doc consumer rules + layout。
35. Write：对于 “other” issue trackers，根据用户描述从头写 `docs/agents/issue-tracker.md`。
36. Done：告诉用户 setup 已完成，以及哪些 engineering skills 现在会读取这些文件。
37. Done：说明他们之后可以直接编辑 `docs/agents/*.md`；只有当他们想切换 issue trackers 或从头开始时，才需要重新运行此 skill。

适用边界 · 注意事项

• 已经完成过本 setup、且无需切换 issue tracker 或从头重配时，不要重复运行。
• 不使用 Matt Pocock 这套 engineering skills（或其 `triage`、seed templates）时，不需要用它配置。
• 用户不希望 agent 修改 `CLAUDE.md` / `AGENTS.md` 或写入 `docs/agents/*.md` 时，不适用。