技能介绍

问题从哪来

关键路径（注册、登录、结账等）一旦只在单元层测过，上线前仍缺浏览器级验证：真实 DOM、网络时序、会话与第三方回调往往把缺陷留到生产。团队还需要在 CI 里可重复跑、可并行、失败能回放，而不是临时点开浏览器点一遍。

技能如何工作

航行者号（Voyager）把 E2E 自动化限定在关键用户旅程，默认走 Playwright（v1.59+），按 PLAN → AUTOMATE → STABILIZE → SCALE → DELIVER 推进：先圈定 @critical / @smoke / @regression 与数据策略，再落地 POM/装置、稳定选择器，最后在流水线里分片与出报告。

核心约定包括：

定位器：优先 getByRole、getByLabel、getByText，再 getByTestId；避免 CSS 层级/位置作为主策略
隔离：每次测试新浏览器上下文；用 storageState 复用登录态，而不是测试间共享状态
确定性：第三方 API 用路由/存根；禁止 page.waitForTimeout() 当同步手段
预算：套件约 ≤10 分钟、单测 ≤2 分钟；片状率 10% 视为阻碍而非常态

子场景通过「食谱」路由：playwright（默认套件）、auth、a11y、visual、api、mobile（Detox/Maestro/Appium 与设备场）、component（真实浏览器 CT）。原生移动、远程设备矩阵、可折叠/隐私清单等会先读对应 reference 再定框架。

边界与注意

单元/集成逻辑应交给 Radar；临时浏览器执行任务交给 Vector；负载/混沌交给 Siege。Voyager 不直接改业务代码，只产出可执行的测试方案与证据。axe 自动化约 WCAG 57% 上限，a11y 需配合 IGT，不能宣称「全自动全覆盖」。引入新 E2E 框架、生产环境测、或大规模 AI 生成/MCP 集成前，应先对齐范围与基础设施变更。

截图预览

使用场景

合并前在 CI 中对注册、登录、结账等 `@critical` 路径跑 Playwright 冒烟，失败用 `trace: on-first-retry` 做 DOM/网络回放。
OAuth 或 MFA 登录要在 fixture 里生成并复用 `storageState`，避免每个用例都从 UI 完整走一遍认证。
已发布 Android/iOS 包需在 PR 门限定 1 个模拟器 + 1 个仿真器烟雾，发版再在真机最旧与最新支持 OS 上验收。
关键页在合并前跑 axe-core 自动规则，并对复杂交互补 IGT 键盘流程，不把 57% 自动化上限当成 WCAG 签收。

适合人员

负责主分支 E2E 通过率与片状率，要把全套件压在约 10 分钟内并做分片、并行与 HTML 报告瓶颈分析的 QA 工程师。
维护 React Native 应用，需要在 Detox 灰盒与 Maestro 跨平台烟雾之间选型并写 accessibility-id 定位的移动测试工程师。
要在 PR 只挡烟雾、夜间或发版门才扩浏览器/设备矩阵，并对接 BrowserStack 等设备云的前端或发布工程师。
支付网关、邮件等第三方回调导致 E2E 不稳定，需要用 Playwright route 或 WireMock 存根并隔离测试数据的测试开发。