用途
本技能用于搭建 Matt Pocock 工程类技能所依赖的按仓库配置。它并非确定性脚本,而是提示驱动流程:先探索仓库,展示发现结果,与用户确认后再写入文件。
主要能力
该技能生成的配置覆盖三项内容:
-
问题追踪器(Issue tracker)——问题存放的位置。默认面向 GitHub,也支持 GitLab 和开箱即用的本地 Markdown。使用 to-issues、triage、to-prd、qa 等技能时会读取和写入它,它们需要知道应调用
gh issue create、在.scratch/下写 Markdown 文件,还是遵循用户描述的其他工作流。 -
Triage 标签词汇——五个规范角色使用的标签字符串:
- needs-triage(维护者需评估)
- needs-info(等待报告者)
- ready-for-agent(已完成规格、可交由 AFK 智能体处理)
- ready-for-human(需要人工实现)
- wontfix(不予处理)
默认每个角色的字符串等于其名称。若仓库已有不同标签名(如
bug:triage而非needs-triage),可在此映射,避免重复创建。
-
领域文档(Domain docs)——CONTEXT.md 和 ADR 的位置及其读取规则。improve-codebase-architecture、diagnose、tdd 等技能会读取 CONTEXT.md 了解项目领域语言,并读取
docs/adr/了解既往架构决策。需确认布局为单上下文(仓库根一个 CONTEXT.md + docs/adr/)还是多上下文(根目录 CONTEXT-MAP.md 指向各上下文 CONTEXT.md,常见于 monorepo)。
使用方式
流程分为五步:
-
探索:读取
git remote -v和.git/config判断是否 GitHub 仓库;检查根目录 AGENTS.md 与 CLAUDE.md 是否存在及是否已有## Agent skills区块;检查 CONTEXT.md 与 CONTEXT-MAP.md;检查docs/adr/及各src/*/docs/adr/;检查docs/agents/是否已有先前输出;检查.scratch/是否已在使用本地 Markdown 约定。 -
展示发现并询问:总结已有和缺失内容,然后逐项引导用户完成三个决策,一次一节,不一次性抛出全部。假设用户不了解术语,每节先做简短说明。
-
确认并编辑:展示将写入的
## Agent skills区块草稿及docs/agents/issue-tracker.md、docs/agents/triage-labels.md、docs/agents/domain.md内容,供用户先行编辑。 -
写入:选择编辑文件——若 CLAUDE.md 存在则编辑它;否则若 AGENTS.md 存在则编辑它;若都不存在则询问用户创建哪一个,不要代为决定。绝不在此二者中已有一个存在时创建另一个。若所选文件中已存在
## Agent skills区块,则就地更新内容而非追加重复项,且不覆盖用户对周边段落的修改。随后依据技能文件夹中的种子模板写入三个文档文件:issue-tracker-github.md、issue-tracker-gitlab.md、issue-tracker-local.md、triage-labels.md、domain.md。对于“其他”问题追踪器,依据用户描述从零编写docs/agents/issue-tracker.md。 -
完成:告知用户配置完成以及哪些工程技能将读取这些文件,并说明日后可直接编辑
docs/agents/*.md,只有需要切换问题追踪器或从头重来时才需重新运行本技能。
适用场景
适用于希望对工程类技能进行按仓库配置的代码仓库,尤其需要明确问题追踪位置、triage 标签映射或领域文档布局的项目。也适用于已有 .scratch/ 本地 Markdown 约定或使用特殊标签命名的仓库。
限制
本技能是提示驱动而非确定性脚本。其支持的默认问题追踪器为 GitHub,另支持 GitLab 与本地 Markdown;其他追踪器(Jira、Linear 等)需用户以一段文字描述工作流,技能将其记录为自由格式文本。关于收费、价格、平台兼容性或效果等信息,资料中暂未提供。