用途:当上下文是 GitHub issue、支持报告、Linear 工单或用户提示,且描述的是可通过可见应用行为复现的缺陷时使用。主要面向 UI、渲染、窗口、设置、编辑器、终端显示、引导等交互类缺陷,屏幕录制或截图能让结果更可操作。父代理不应自行在本地手动复现,除非用户明确要求,而应启动一个或多个启用计算机使用的 Oz 云端代理来运行应用、交互并采集视觉证据。
主要能力:读取报告并提取报告行为、预期行为、复现步骤、环境约束(操作系统、应用版本/构建/渠道、shell、功能开关、账户状态)以及附件线索;判断技能是否适用;对多条可能复现路径,可在一次 run_agents 批量中启动多个子代理,各自负责不同假设或环境变体(不同操作系统、首次运行状态、稳定版与开发版、不同设置、shell、面板布局等)。等待所有子代理报告后再汇总,区分已确认、部分确认、未复现、受阻和未测试假设。
使用方式:优先使用与报告者完全一致的应用版本/构建/渠道的可运行产物,不静默替换为最新构建;若无法找到或安装,需明确说明并记录回退决策。子代理需创建专用产物目录(如 ~/bug-repro-primary),默认录制 repro.mp4,补充有序截图,并维护包含文件名、时间戳、可见状态、动作、是否显示缺陷的清单。复现流程包括确认环境、确定版本、从最干净且匹配报告的状态开始、先按原步骤复现、失败后测试假设、最多两次针对性变体、遇崩溃或阻塞时截图并收集非敏感日志。
适用场景:UI 可见缺陷、交互缺陷、渲染/布局缺陷、引导缺陷,以及屏幕录制或截图有用的缺陷。
限制:不适用于纯后端、CI、构建、依赖或纯文本代码问题,除非明确要求视觉复现。不得向公开报告者索要凭据、令牌、私有仓库或账户标识;不得在录制、截图、日志或报告中包含密钥、认证令牌、私有 URL 等;未经明确授权不得创建或登录账户;不得向 GitHub、Linear 或外部服务发帖,除非明确指示;避免破坏性操作,仅删除当前复现环境的测试状态并报告重置内容。若报告需要凭据、私有账户状态或复现环境不具备的能力,应明确报告该约束而非猜测。若复现步骤不完整,可借助代码库知识提出可能的应用状态,但不得编造报告者环境事实。成功标准包括:确认复现并附屏幕录制与精确步骤,或范围明确的未复现及已测试假设;清晰的产物路径;已测试与未测试变体的简明摘要;足够工程师重复测试的环境细节;无泄露密钥或凭据。