用途:为 Matt Pocock 工程技能准备每个仓库都需要的配置,集中在 AGENTS.md 或 CLAUDE.md 的 ## Agent skills 块,以及 docs/agents/ 下的三个说明文件。
主要能力:
- Issue 跟踪器:确定 issue 存放在哪里,默认 GitHub(用 gh CLI),也支持 GitLab(用 glab CLI)、本地 markdown(.scratch/<feature>/)、以及用户自述的其他工作流(Jira、Linear 等)。
- 分诊标签词汇:映射五个规范角色——needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix,默认字符串与角色名相同。
- 领域文档:确认单上下文(根目录 CONTEXT.md + docs/adr/)或多上下文(根目录 CONTEXT-MAP.md 指向各上下文的 CONTEXT.md)。
使用方式:这是提示驱动的技能,不是确定性脚本。先探索仓库现状,读取 git remote、AGENTS.md/CLAUDE.md、CONTEXT.md、CONTEXT-MAP.md、docs/adr/、docs/agents/、.scratch/ 等;再逐个引导用户确认三个决策;展示草稿供用户编辑后写入。写入规则:CLAUDE.md 存在则编辑它,否则编辑 AGENTS.md,二者都不存在时由用户选择创建哪一个;已有 ## Agent skills 块则原地更新,不重复追加、不覆盖周边用户编辑。三个文档以技能文件夹内的种子模板为起点。
适用场景:首次为仓库接入这些工程技能,或需要统一 issue 跟踪、分诊标签和领域文档约定时。
限制:不提供确定性脚本;GitHub、GitLab 之外需用户自行描述工作流;完成后可直接编辑 docs/agents/*.md,只有切换 issue 跟踪器或从头开始时才需重跑。其他细节暂未提供。