用云端 computer-use 代理复现 UI 类…

当需要复现 GitHub issue、支持工单或用户描述中的交互/视觉类 bug 并产出可视化证据时使用。

适用场景

解决思路

1. 父代理不要自行在本地手动复现 UI bug，除非用户明确要求；应启动一个或多个启用 computer use 的 Oz 云端代理来运行应用、交互并捕获视觉证据。
2. 仔细阅读 bug 报告并提取：报告行为、期望行为、复现步骤（若有）、OS/应用版本/构建/渠道/shell/功能开关/账号状态等环境约束，以及能缩小复现路径的截图、视频、日志或评论。
3. 判断技能是否适用：适用于 UI 可见、交互、渲染/布局、引导流程等 bug，以及屏幕录制或截图有帮助的场景；不适用于纯后端、CI、构建、依赖或纯文本代码问题，除非明确要求视觉复现。
4. 若报告需要凭据、私有账号状态或复现环境不具备的能力，应明确报告该约束，而不是猜测。
5. 若复现路径明确，启动一个启用 computer use 的 Oz 云端代理。
6. 若存在多条可能复现路径，在一次 run_agents 批量调用中启动多个 Oz 云端代理，给每个子代理分配不同的假设或环境变体，例如：不同 OS 或桌面环境、全新首次运行状态 vs 已初始化的本地状态、stable vs dev 构建、全新设置 vs 已有设置、不同 shell/提示符/面板布局/设置开关。
7. 若步骤不完整，利用代码库知识提出可能的应用状态并分配子代理调查这些状态；不要编造原始报告者环境的事实。
8. 等待所有子代理报告后再汇总，区分已确认复现、部分复现、未复现、受阻和未测试的假设。
9. 优先使用用户报告的精确应用版本/构建/渠道进行复现（当存在可运行的对应产物时）；当能安装更贴近报告者的产物时，不要悄悄替换为最新可用构建。
10. 当更匹配报告者环境且仓库特定指南允许时，优先使用已发布或打包的可运行产物，而非源码构建。
11. 若无法找到或安装精确版本/构建，应明确报告，说明尝试过什么，仅在有助于继续调查时使用最接近且有依据的降级方案。
12. 在 manifest 和最终报告中记录请求的报告者版本、安装的测试版本、产物来源及任何降级决策。
13. 若消费方仓库附带 reproduce-bug-report-local 配套技能，且该技能可用或在提示中被引用，应阅读并应用其仓库特定的范围、应用设置、环境和工作流指南作为补充；本地配套可缩小范围或特化设置，但不应重新定义本核心技能的证据、产物、报告或安全预期。
14. 使用如下形状的 run_agents 调用：summary 说明启动 Oz 云端 computer-use 代理复现 UI bug 并录制屏幕；remote.computer_use_enabled 设为 true；agent_run_configs 中列出各子代理（如 repro-primary 及可选的 repro-variant）及其 prompt；base_prompt 为下方共享子提示；当额外子代理会重复相同步骤时省略；除非用户指定模型，否则省略 model_id。
15. 给每个子代理提供共享指令，再追加子代理特定的复现路径或假设。共享指令要求：忠实复现报告行为；默认录制屏幕（多数 UI bug 涉及运动、过渡或多步交互，视频比静帧更有力），截图作为补充，仅对真正静态渲染才以截图为主；若步骤不清或不完整，利用代码库和产品知识识别可能产生该行为的应用状态并测试分配的假设；报告清晰的复现证据而非仅意见。
16. 共享指令的输入包括：bug 报告上下文（粘贴或总结 issue 正文、评论、截图/视频描述、标签及相关元数据）、分配的复现路径或假设、报告者应用版本/构建/渠道、构建/应用目标（要安装的精确可运行产物，或无法获得精确产物时的有依据降级方案）。
17. 共享指令的安全与隐私要求：不要向公开报告者索要凭据、令牌、私有仓库、私有工作区名称或私有账号标识；不要在录制、截图、日志、manifest 或最终报告中包含密钥、认证令牌、私有 URL、Authorization 头、刷新令牌或其他私有账号细节；除非提示和仓库特定指南明确授权安全测试认证流程，否则不要创建或登录账号；若分配的报告无法在允许的认证/状态约束内执行，停止并报告受阻；除非明确指示，不要向 GitHub、Linear 或外部服务发表评论；当提供 Slack 线程上下文（频道 id 和线程）时，将复现证据（录制）发回该线程以便请求者看到，不要发到其他频道或服务；避免破坏性操作，若复现需要删除应用状态，只删除当前复现环境的测试状态并准确报告重置了什么。
18. 共享指令的产物工作流：创建以变体命名的专用产物目录，如 ~/bug-repro-primary；默认录制复现屏幕并保存到产物目录，使用描述性名称如 repro.mp4；截图作为补充（仅对真正静态渲染才作为主要产物），使用有序文件名如 01-initial-state.png、02-before-click-settings.png、03-after-click-settings.png；在产物目录维护简短 manifest，包含录制或截图文件名、时间戳、可见应用状态、刚执行或即将执行的操作、截图是否显示所报告的 bug；若 harness 支持内置截图或产物上传则使用，否则将产物留在目录中并报告路径。
19. 共享指令的复现工作流：1) 确认测试环境：OS、架构、显示/会话类型、相关时的 shell，以及可见的应用/构建/版本；2) 从报告中识别报告者的精确应用版本/构建/渠道（若有），然后使用最接近且仓库批准的可运行产物；3) 若无精确报告者版本，记录版本未知并为报告选择最有依据的安装目标，明确说明降级方案；4) 从与报告匹配的最干净状态开始，若 bug 依赖已有设置或持久化本地状态则不要重置应用状态；5) 在尝试 bug 特定复现前达到报告所需的基线应用状态；6) 开始屏幕录制并在尝试 bug 特定复现前捕获基线截图；7) 若有精确提供的复现步骤，先严格遵循；8) 若精确步骤未复现，测试分配的假设并记录与报告的分歧之处；9) 若 bug 出现，停止改变变量并捕获足够证据使复现可操作；10) 若 bug 未出现，最多做两次由报告或代码路径假设直接支持的有针对性变体；11) 若应用崩溃、挂起或阻塞进度，截图并收集能解释阻塞的非敏感日志或终端输出。
20. 共享指令的代码路径调查（针对不清晰步骤）：在代码库中搜索报告中提到的 UI 字符串、标签、功能名、设置键、遥测名、路由名和组件；识别可能产生报告行为的组件、模型、功能开关或状态转换；利用该调查选择有针对性的 UI 操作而非广泛探索性点击；报告为假设提供依据的文件或符号，但最终报告聚焦于复现证据。
21. 共享指令的报告要求：在结论前给出简短 bug 摘要，包括 issue/报告标识（若有）、报告行为和期望行为；复现状态：已确认、部分确认、未复现或受阻；执行的确切步骤；环境和应用/构建信息；报告者请求的应用版本/构建/渠道、安装的测试版本/构建/渠道，以及产物来源或降级说明；观察到的行为是否与报告匹配及匹配程度；屏幕录制（及任何补充截图）附简短描述和产物路径或附件名；收集的任何日志、崩溃输出或诊断信息（已脱敏）；若已调查，最可能的代码路径或状态；仅在会实质性改变下一步行动时给出建议的下一步调试动作或后续问题。
22. 子提示模式——主复现子代理：用于步骤清晰的报告，要求先严格遵循 bug 报告步骤再尝试变体，优先匹配报告者的 OS、应用渠道、允许的应用状态、设置、shell 和布局；若这些细节缺失，选择最常见路径并明确列出假设。
23. 子提示模式——变体子代理：用于有特定替代条件值得测试时，要求只测试该变体分配的环境或状态，不要重复主代理的完整搜索空间，报告该变体是否改变结果，并对任何差异附上截图。
24. 子提示模式——代码路径假设子代理：用于复现步骤缺失或模糊时，要求从报告中的字符串、UI 标签、设置名、功能名或截图追踪可能的代码路径，然后选择应触发可疑状态的有针对性 UI 路径，报告用于形成假设的代码路径及测试的视觉结果。
25. 成功标准：产出已确认复现（含屏幕录制、必要时截图和确切步骤），或范围明确且已测试假设的未复现；清晰的视觉证据产物路径或附件；哪些变体已测试、哪些未测试的简明总结；足够的环境细节供工程师重复测试；无泄露的密钥、凭据、私有账号细节或不必要的公开评论。
26. 子代理完成后按以下结构汇总：Bug summary（issue/报告、报告行为、期望行为）；Reproduction status（confirmed | partially confirmed | not reproduced | blocked）；What was tested（各变体/子代理的步骤和环境）；Evidence（截图/产物路径及其展示内容）；Findings（观察行为 vs 报告行为、已知的可能状态/代码路径）；Next step（一个具体调试动作或后续问题）。

适用边界 · 注意事项

• 纯后端、CI、构建、依赖或纯文本代码问题，除非明确要求视觉复现。
• 报告需要凭据、私有账号状态或复现环境不具备的能力时（应报告约束而非猜测）。
• 复现路径明确且只需单个代理时，不要启动会重复相同步骤的额外子代理。