用途:该技能用于在代码仓库中初始化并标准化工程协作约定,涵盖问题跟踪、分诊标签体系、领域建模文档以及代理指令文件四个部分,适合在新建或整理仓库工作流时使用。
主要能力:
- 问题跟踪配置:支持 GitHub(gh)、GitLab(glab)或本地 Markdown(.scratch/)三种方式,并将决策记录到 docs/agents/issue-tracker.md。
- 分诊标签词汇:定义五个规范角色 needs-triage、needs-info、ready-for-agent、ready-for-human、wontfix,映射到仓库标签,写入 docs/agents/triage-labels.md;仅当仓库中已有分诊技能时才配置。
- 领域文档布局:默认单上下文(根目录 CONTEXT.md);仅检测到 monorepo 信号(workspaces、packages/* 等)时才建议多上下文(CONTEXT-MAP.md),写入 docs/agents/domain.md。
- 代理指令接入:在 AGENTS.md(或 CLAUDE.md)中添加 ## Agent skills 区块,指向上述文档,使新创建的子代理能立即读取仓库约定。
使用方式:技能按步骤执行。第一步自动探查仓库:检查 git remote -v、根目录指令文件(AGENTS.md、CLAUDE.md)、docs/adr/ 及工作区配置(如 pnpm-workspace.yaml、packages/),以识别已有跟踪或分诊约定,避免重复询问用户。第二步按 A(跟踪方式)、B(标签)、C(领域)分段给出建议供确认,并逐项记录到 docs/agents/ 下的三个文档。第三步将摘要指针写入 AGENTS.md 或 CLAUDE.md 的 Agent skills 区块。
约束与限制:明确禁止同时创建 AGENTS.md 和 CLAUDE.md,若两者之一已存在则就地编辑,都不存在时需先询问用户,且始终只维护一个规范代理文件;单包仓库默认单上下文,不强制多上下文;不得未经询问覆盖已有的自定义标签,而应将现有标签映射到规范角色;分诊标签仅在仓库含分诊技能时配置。具体收费与平台支持等信息资料未提供。
适用场景:仓库初始化、统一团队问题跟踪与分诊流程、建立领域文档结构与代理协作约定。