用途:为公开的 GitHub 缺陷跟踪仓库(与源码仓库分离,用于用户和测试者提交缺陷、反馈与功能请求)创建 /bug-tracker 工作流所需的标签体系,并把该跟踪仓库记录到本仓库的 agent 配置中,使后续 /bug-tracker 无需再次询问即可定位。
前提:已安装并认证 GitHub CLI(gh auth status),且对目标仓库有管理标签的权限。
主要步骤:1)解析跟踪仓库,依次取显式参数 /init-bug-tracker <owner/repo>、CLAUDE.md 或 AGENTS.md 中 ## Agent skills 下已记录的 ### Bug tracker 子块,否则询问维护者;用 gh repo view <owner/repo> 确认可达。2)派生 area:* 标签:读取源码仓库的 README、顶层目录与 CONTEXT.md,提出 4–8 个组件(如 area:pdf-editor、area:annotations),由维护者确认或替换;若产品代码不在当前目录则向维护者索取组件列表。3)用 gh label create --force 创建标签,--force 幂等,可安全重跑。固定标签分四组:Triage & state(needs-triage、needs-info、ready-for-agent、ready-for-human、in-progress、resolved、wontfix)、Type & category(bug、enhancement、feedback、documentation、question)、Priority & severity(priority:critical/high/medium/low)、Verification & testing(tester-verified、needs-reproduction)。4)初始化 Issue 模板与 README:生成 .github/ISSUE_TEMPLATE/bug_report.yml、feature_request.yml、config.yml(blank_issues_enabled: false)及 README.md,并推送到跟踪仓库。5)在 CLAUDE.md 或 AGENTS.md 的 ## Agent skills 下新增或更新 ### Bug tracker 子块,记录公开报告提交地址。6)用 gh label list -R "$REPO" --limit 200 验证标签,并检查 https://github.com/<owner/repo>/issues/new/choose 的模板可用性,最后向维护者报告状态。
限制:需要 GitHub CLI 认证与标签管理权限;area 标签需人工确认;具体模板字段内容与颜色等细节以实际资料为准,未提供的部分暂未说明。