身份
- User ·
/setup-matt-pocock-skills · 禁止隐式调用
- Prompt-driven（Explore → ask → confirm → write），非确定性脚本
- 每目标仓库一次；工程流前置配置层
五步
- Explore — remote、CLAUDE/AGENTS、CONTEXT*、docs/adr、docs/agents、.scratch、triage 是否安装、monorepo 信号
- Present / A·B·C — 一节一答；推荐答案前置
- Confirm — Agent skills 块 + docs/agents 草稿可改
- Write — 落盘
- Done — 点名下游；提醒手改 vs 重跑
决策点 A / B / C
| 节 |
问什么 |
跳过 / 默认 |
产物 |
| A Tracker |
GitHub / GitLab / Local .scratch / Other |
按 remote 推荐 GH/GL |
docs/agents/issue-tracker.md |
| B Labels |
保留默认五标签？ |
无 triage skill → 整节跳过 |
triage-labels.md + Agent 子块（条件） |
| C Domain |
仅 monorepo 时问 multi |
默认 single，不问 |
docs/agents/domain.md |
默认 triage 五角色
needs-triage · needs-info · ready-for-agent · ready-for-human · wontfix
映射表：左 canonical / 右 tracker 真实字符串。改右列适配已有标签。
写入清单
| 路径 |
条件 |
Seed |
docs/agents/issue-tracker.md |
总是 |
github / gitlab / local · Other=用户 prose |
docs/agents/domain.md |
总是 |
domain.md |
docs/agents/triage-labels.md |
triage 已装且 B 跑过 |
triage-labels.md ± override |
## Agent skills in CLAUDE/AGENTS |
总是 |
见下「根文件规则」；Triage 子块条件同 labels |
根文件规则（CLAUDE / AGENTS）
CLAUDE.md 存在 → 只改它- 否则
AGENTS.md 存在 → 改它
- 都无 → 问用户建哪个
- 禁止双建；已有 Agent skills 块 → 原地更新，不重复追加，不盖用户其它段
Agent skills 块骨架
## Agent skills
### Issue tracker
[one-liner]. See `docs/agents/issue-tracker.md`.
### Triage labels ← 仅 triage 安装时
[one-liner]. See `docs/agents/triage-labels.md`.
### Domain docs
[single-context | multi-context]. See `docs/agents/domain.md`.
Tracker 速比
|
GitHub |
GitLab |
Local |
| CLI |
gh |
glab |
读写文件 |
| Publish |
gh issue create |
glab issue create |
.scratch/<feature>/ |
| 票文件 |
远程 issues |
远程 issues |
issues/NN-slug.md（禁合并单文件） |
| PR/MR 面 |
默认 no（后改文件） |
默认 no |
N/A |
| Wayfinder map |
issue + wayfinder:map |
同左（或 epic） |
.scratch/<effort>/map.md |
| # 空间 |
issue/PR 共享 |
issue/MR 分离 |
路径/序号 |
下游谁读
| 文件 |
消费者 |
| issue-tracker.md |
to-spec · to-tickets · triage · wayfinder（Wayfinding ops）· code-review（fetch） |
| triage-labels.md |
triage · to-spec / to-tickets（ready-for-agent 等映射） |
| domain.md |
探索时读 CONTEXT/ADR 的规则；与 domain-modeling 懒创建一致 |
手改 vs 重跑
- 手改
docs/agents/*：标签串、PR 面 flag、Other 流程细节、domain 布局说明、Agent skills one-liner
- 重跑 setup：切换 tracker，或从头 scaffold
常见坑（一览）
- 安装 skill ≠ 已配置目标仓
- setup 不创建 CONTEXT.md（懒创建归 domain-modeling）
- 无 triage 却写 labels / 无 monorepo 却逼 multi
- 跳过 Confirm；双写 CLAUDE+AGENTS；Local 合并 tickets 单文件
- setup 主动打开 PR-as-surface（应保持默认 off）
验收（It's working if）
docs/agents/issue-tracker.md + domain.md（± triage-labels.md）存在## Agent skills 出现在 CLAUDE 或 AGENTS- 推荐 tracker 匹配 remote；labels 匹配真实 tracker 字符串
- 之后 triage / to-tickets 作用在正确位置