用途
Setup Matt Pocock's Skills 用于为仓库搭建工程类技能所依赖的仓库级配置。它把三类约定固化到文件中,供后续技能读取:
- Issue tracker:issue 存放位置。默认 GitHub;GitLab 与本地 markdown 也可开箱支持;其他系统(如 Jira、Linear)可由用户用一段话描述工作流后记录为自由文本。
- Triage labels:五个标准分诊角色对应的标签字符串:needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix。
- Domain docs:GLOSSARY.md 与 ADR 的存放位置,以及读取它们的消费方规则。
该技能是提示驱动(prompt-driven)的,不是确定性脚本:先探索、展示发现、与用户确认,然后写入。它同时服务于 Matt 与 Pstack 两个入口,共用一份项目契约;已存在的选择和授权会被复用,只对未定的 tracker、标签或文档决策提问。个人模型角色覆盖仍可通过 /pstack-setup 另行设置。
主要能力与流程
- 探索:检查 git remote 与 .git/config 判断是否为 GitHub 仓库;查看根目录 AGENTS.md、CLAUDE.md 是否已有 ## Agent skills 区块;检查 GLOSSARY.md、GLOSSARY-MAP.md 及旧版 CONTEXT.md / CONTEXT-MAP.md;查看 docs/adr/ 与 src//docs/adr/;确认 docs/agents/ 是否已有先前输出;检查 .scratch/ 是否表明已使用本地 markdown issue 约定;判断 triage 技能是否已安装(决定是否执行标签部分);检查 monorepo 信号(pnpm-workspace.yaml、package.json 的 workspaces 字段、含自身 src/ 的 packages/)。
- 呈现发现并提问:按 A(issue tracker)、B(分诊标签)、C(领域文档)顺序逐节确认,每节先给出推荐答案。若 triage 未安装则跳过 B;若未发现 monorepo 信号则跳过 C(默认单上下文)。
- 确认与编辑:展示拟写入 CLAUDE.md / AGENTS.md 的 ## Agent skills 区块草稿,以及 docs/agents/issue-tracker.md、domain.md、triage-labels.md(仅安装了 triage 时)的内容,允许用户在写入前修改未定选项。
- 写入:优先编辑已有的 CLAUDE.md;否则编辑 AGENTS.md;两者都不存在时建议创建 AGENTS.md(Codex 与 Claude Code 都会读取)。保留现有指令来源,不重复规则;若已有 ## Agent skills 区块则就地更新而非追加。之后依据技能文件夹中的种子模板(issue-tracker-github.md、issue-tracker-gitlab.md、issue-tracker-local.md、triage-labels.md、domain.md)生成文档;对其他 tracker 则根据用户描述从零编写。若在 GitHub/GitLab 上且已获授权,创建 tracker 中缺失的标签(gh label create / glab label create)。
- 完成:告知用户配置完成及哪些技能会读取这些文件,并说明日后可直接编辑 docs/agents/*.md;仅在需要切换 issue tracker 或从头重来时需重新运行本技能。
使用方式
在仓库中运行该技能一次,随后按提示逐节确认。若选择 GitHub 或 GitLab 且没有指向该主机的 git remote,需要先提供仓库 URL 并完成 git init / git remote add origin <url>,以 gh repo view / glab repo view 能从该目录打印项目为准。完成后,用户可自行编辑 docs/agents/*.md。
适用场景
- 首次在新仓库中启用相关工程技能前的初始化。
- 需要统一团队在 issue 存放、分诊标签与领域文档位置上的约定。
- 单人项目或无远程仓库,可使用本地 markdown issue 约定。
限制
- 该技能是提示驱动的交互流程,需人工确认各节选择。
- 分诊标签部分仅在 triage 技能已安装时执行。
- 多上下文文档布局只在检测到 monorepo 信号时提供。
- 关于支持的具体技能清单、收费、平台等资料暂未提供。