Voyager 是面向 E2E 测试编写的技能,主要服务于浏览器与原生移动应用的关键用户旅程验证、跨浏览器与多设备矩阵校验,以及可接入 CI 的测试自动化。
用途与能力:设计基于 Playwright/Cypress/WebdriverIO 的 E2E 套件;创建 Page Object Model 提升可维护性;测试认证与授权流程;配置并行执行与 CI 集成;搭建视觉回归测试;集成无障碍(a11y)测试;借助 Playwright MCP 与 Planner/Generator/Healer 智能体做 AI 辅助测试;系统化诊断不稳定的 flaky 测试并给出隔离与稳定策略;通过 page.screencast 生成自动化工作的视频凭证;用 npx playwright trace 做命令行 trace 分析;以 APIRequestContext 做仅 API 的用户旅程 E2E 校验;面向已发布应用的移动端原生 E2E(Detox、Maestro、Appium 3.x、XCUITest、Espresso+Compose);云设备农场矩阵执行(BrowserStack、Sauce Labs、AWS Device Farm、Firebase Test Lab、LambdaTest);组件级真实浏览器测试;原生视觉回归与自愈;折叠屏/大屏/多窗口自适应布局测试;隐私清单感知的测试脚手架;XCUITest 套件与 xcresult 证据;fastlane snapshot 生成多语言 App Store 截图;将 xcodebuild、xcresulttool、模拟器池与远程 XCUITest 设备农场接入 CI。
使用方式:Web E2E 默认使用 Playwright(v1.59+),仅在既有栈或平台要求下选择 Cypress、WebdriverIO 或 TestCafe;原生移动默认 Detox(RN)或 Maestro(跨平台冒烟),矩阵广度要求高时升级到 Appium。优先使用可访问选择器(getByRole、getByLabel、getByText,其次 getByTestId),禁止以 CSS 类或位置选择器作为主要定位;禁用 page.waitForTimeout 等固定延时同步;测试间保持独立、可并行;用 storageState 复用登录态;为第三方 API 打桩;用 @critical/@smoke/@regression 标记套件;配置 trace: 'on-first-retry'。
限制与边界:仅测试关键用户旅程,逻辑层测试交回单元/集成层;性能剖析、负载/混沌测试、临时浏览器任务分别交由其他专项处理。预算方面:套件不超过 10 分钟、单测不超过 2 分钟、主分支通过率高于 90%、flaky 率低于 3%(超过 10% 视为阻塞)。采用新框架、生产环境测试、测试基础设施变更、引入 AI 生成测试等需先确认。ax-core 加 IGT 的无障碍覆盖上限为 57%,不应仅凭自动化断言已覆盖无障碍。
具体版本细节、云测试、移动测试、XCUITest 模式与环境管理等更多内容,资料指向 reference 目录下的相应文档。