用途:bug-triage 用于处理用户报告的 bug、回归、运行时错误、构建失败或测试失败,目标是复现、诊断、根因分析,并在获得授权时修复。
主要能力与流程:先确定范围,阅读仓库说明,检查当前分支、状态和相关 diff,判断用户只要诊断还是也授权修复;在追问缺失信息前先查看已有错误、日志、测试和代码,并记录预期行为、实际行为、环境、频率和最后已知正常状态。随后复现与隔离:使用最小可靠复现,保留原始失败输出;若为间歇性失败,逐项控制时间、随机性、并发、数据和重试;端到端追踪失败路径,编辑前搜索函数或组件的所有调用方;提出可证伪假设并运行最窄的验证;仅在回归边界能显著缩短搜索时使用历史或 git bisect。需明确区分:已确认的产品回归、既有或基线失败、环境/凭据/服务/依赖失败、证据不足无法复现。
修复(获授权时):添加或调整最小的回归检查,使其对已确认原因失败;修复共享根因而非只保护一个可见调用方;避免无关重构、依赖升级、格式变动和宽泛异常处理;重新运行复现、聚焦回归检查和最小相关项目检查。使用仓库已选定的包管理器、包装器和命令,从仓库说明、清单、锁文件和脚本推断,不要仅因本地已安装就替换工具。
报告:包含观察到的确切症状与影响范围、根因(已确认解释或明确标注的主要假设)、变更(文件与行为变化,或仅诊断)、验证(命令与结果,含基线失败)、剩余风险(未测试路径、不稳定行为或外部阻塞)。仅当用户需要可复用录入表单时使用 references/bug-report-template.md。
限制:资料未提供具体安装命令、收费、价格、平台或效果信息。