用途:为使用 Matt Pocock 工程技能的仓库搭建按仓库维度的基础配置,让后续技能知道议题在哪里跟踪、由谁负责、最终 PR 基于哪个分支、分诊使用哪些标签、领域文档放在何处。该技能是提示驱动的流程,并非确定性脚本,会先探查再展示具体配置,获得用户授权后才写入。
main 能力与流程:
- 探查:检查 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 议题约定。对 GitHub 还会确认默认分支、最终 PR 基准、开发者身份、已有 Project 配置,并用 gh project list/view/field-list 检查访问权限;缺少读取权限需 read:project,写入需 project,可用 gh auth refresh --hostname <host> --scopes project 授权。
- 呈现并询问:按部分依次确认,每部分给出推荐答案。Section A 议题跟踪器(GitHub Issues 用 gh;GitLab Issues 用 glab;本地 Markdown 位于 .scratch/<feature>/;或其他如 Jira、Linear,由用户描述工作流),记录到 docs/agents/issue-tracker.md。Section A.1 归属与工作跟踪:推荐已验证的现有 GitHub Project,记录 owner、编号、URL、Status 字段名及 todo、in-progress、waiting-validation、blocked、paused、done 的实际选项名;仅当用户选择 issue-only 时记 Project: disabled。新 PRD 归属驱动会话的开发者,子项继承父项 assignee,父项未分配时回退到驱动开发者。最终 PR 基准与实际默认分支分开记录,修改默认分支需明确指令。
- Section B 分诊标签:仅当 triage、to-spec 或 to-tickets 已安装时运行;默认为五个规范角色标签 needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix,若跟踪器已有其他名称则收集覆盖映射。
- Section C 领域文档:默认单上下文(根目录一个 GLOSSARY.md + docs/adr/),仅当探查到 monorepo 信号(pnpm-workspace.yaml、package.json workspaces、packages/* 含自身 src/)时才提供多上下文(根 GLOSSARY-MAP.md 指向各上下文 GLOSSARY.md)。
- 写入:若 CLAUDE.md 存在则编辑它,否则若 AGENTS.md 存在则编辑它;两者都不存在时询问用户创建哪一个,不代为选择。不重复创建另一个文件,已有 ## Agent skills 区块则原地更新,不覆盖用户其他编辑。写入 docs/agents/issue-tracker.md、domain.md、triage-labels.md(Section B 运行时),并在 GitHub/GitLab 上按需创建缺失标签(gh label create / glab label create)。
- 验证与报告:回读已写入的跟踪器策略与所选 Project 的字段和映射,仅验证实际完成的远程更改,单独报告待处理的授权、工作流或 UI 步骤;选择 configuration 已写入且所需远程配置已验证才算完成,issue-only 跟踪无需 Project 验证。之后可直接编辑 docs/agents/*.md;只有要切换议题跟踪器或从头重来时才需重新运行本技能。
使用方式:在目标仓库中调用该技能,按提示逐段确认配置。
适用场景:采用 Matt Pocock 工程技能、需要统一议题跟踪、所有权、Project 状态、分诊标签与领域文档约定的仓库,尤其是团队协作或多包仓库。
限制:不提供价格、收费、平台支持范围等信息,资料暂未提供;GitHub Project 相关操作依赖 gh CLI 的授权范围与组织权限,无访问权限不等于项目不存在;缺失事实会明确标注为待定。