用途
本技能用于在 Linux 上验证 Warp 的首次安装与新手引导流程，通过并行云代理获得比单条线性走查更广的分支覆盖。父代理不进行本地走查，而是编排多个 Oz 云代理完成验证。
主要能力
- 并行启动两个带计算机使用能力的 Oz 云代理作为基线探索者。
- 两个基线代理安装适合其平台的最新稳定版 Warp Linux 包（仅使用官方稳定下载，不使用 Preview、Alpha、源码构建或仓库开发构建），并在每个可见引导步骤截图，直到 Warp 进入可用终端会话。
- 一个子代理验证免登录流程，另一个使用托管密钥 ONBOARDING_AGENT_FTUE_REFRESH_TOKEN 验证已登录流程。
- 基线代理负责识别有意义的备选引导分支，并返回后续云代理的具体计划。
- 父代理汇总并去重分支建议，启动有界第二轮定向代理（默认最多四个），以覆盖更多路径；除非用户明确要求穷尽覆盖，或基线报告显示超过四个明显不同的高价值分支。
- 若无具体分支点被观察到，则不启动推测性跟进，并报告覆盖止于基线轮。
使用方式
父代理工作流：
- 在单次并行 run_agents 批次中启动恰好两个远程 Oz 云代理，启用计算机使用。除用户提供环境外，不使用特定环境假设；若未提供，则省略环境 ID，由 Warp 选择默认远程环境。
- 为两个基线子代理提供共享子提示词及相应流程专属提示词（免登录或已登录）。
- 等待两份基线报告，报告须包含：完成的基线走查结果与产物；观察到的 UI 质量问题、疑似缺陷、错误状态或粗糙点的简要列表（可见时附截图）；按优先级排列的后续覆盖计划。若 ONBOARDING_AGENT_FTUE_REFRESH_TOKEN 缺失或认证失败，已登录基线子代理视为受阻。
- 依据两份基线报告构建合并覆盖图，去重到达相同可见状态或相同决策面的建议。
- 为最有价值的后续引导分支启动第二轮 run_agents 批次（启用计算机使用）。优先选择会实质性改变可见 UI、可用控件、下游界面、认证状态或设置结果的分支；优先可能暴露正确性、打磨度、布局、截断、加载或校验问题的路径。默认最多四个跟进代理。
- 为每个跟进子代理提供共享子提示词、跟进流程提示词、与其分配的认证状态匹配的免登录/已登录流程提示词，以及一条来自基线报告的合成分支任务。
- 等待全部跟进报告后，再总结覆盖率、问题、产物以及仍值得后续运行探索的分支。
子代理共同指令要点：检测 CPU 架构（uname -m）与包管理器/发行版；按稳定 Linux 包映射选择原生包，优先于 AppImage；创建流程专属产物目录；通过仅删除 Warp 专属配置/数据/缓存/状态目录（如 ~/.config/warp-terminal 等）确保全新首次运行状态；截图工作流要求首屏交互前截图、每次用户操作前截图、操作后 UI 变化再截图，使用带流程前缀的顺序文件名，并维护截图清单；引导行为上基线代理选择默认或最保守选项，记录值得单独覆盖的分支点；观察到遥测、shell、主题、编辑器导入或代理集成选择时走默认路径并记录；终端验证运行无害命令（如 echo warp-onboarding-logged-out-ready 或 echo warp-onboarding-logged-in-ready）并截图。
对 UI 质量需关注视觉破损、明显未完成、错位、截断、拥挤、低对比度、意外空白、卡加载、与相邻步骤不一致，以及认证失败、按钮跳转失败、无响应控件、重复覆盖层、缺失图片、选择后状态损坏等可操作错误；对每个可疑状态截图并记录屏幕、动作、异常及是否阻塞，描述须事实化，不确定时称其可疑而非断言为缺陷。不得将截图或日志上传至公开外部服务；优先使用测试框架内置产物机制，否则留在产物目录并报告路径。
适用场景
- 需要在 Linux 上验证 Warp 首次安装和引导体验。
- 需要比较免登录与已登录两种引导流程。
- 需要借助云代理覆盖真实用户可能遇到的多条引导分支。
限制与注意事项
- 父代理不进行本地走查，验证由云代理完成。
- 已登录基线依赖托管密钥 ONBOARDING_AGENT_FTUE_REFRESH_TOKEN；该密钥为内部团队管理的云代理密钥，认证为专用的非员工、非 warp.dev 的 FTUE 测试用户；轮换命令为 oz-dev secret update --team --value-file <private-token-file> ONBOARDING_AGENT_FTUE_REFRESH_TOKEN。私密令牌文件仅作本地草稿材料，不得读入聊天、打印、暂存、提交、上传或包含在产物中，更新托管密钥后删除。
- 不得泄露密钥、刷新令牌、ID 令牌、认证重定向 URL 或 Authorization 头到清单、日志、shell 历史、截图或报告中。禁止使用 set -x；避免将原始令牌写入 shell 历史或进程列表；不得将含令牌的重定向 URL 传给 shell 命令、桌面 URI 处理程序、浏览器地址栏、进程参数、日志、产物或报告，尤其不得用 xdg-open、gio open、open 等命令处理重定向 URL。若需构造认证重定向 URL，只能保存在剪贴板或仅用户权限的私密临时文件，通过 Warp 可见的 Paste Auth Token 流程粘贴后立即删除临时文件。
- 免登录流程不得创建账户、登录或使用真实用户身份；若流程要求登录且无跳过/无账户继续选项则报告受阻。
- 免登录与已登录流程的完整命令示例与 oz-dev 相关密钥轮换命令见官方文档。