SuperAPI AI 工具集

playwright-e2e-builder

测试与质量

查看项目

更新于 10-15 14:28

技能介绍

用途

本技能用于在现有项目中规划并构建完整的 Playwright 端到端(E2E)测试套件。当需要从零搭建 Playwright、为关键用户流程(注册、结账、仪表盘等)编写 E2E 测试、实现可维护的 Page Object Model 架构、配置跨测试的认证状态持久化、设置截图视觉回归测试,或将 Playwright 集成到 CI/CD(含分片与重试)时使用。

主要能力

  • 探索现有项目:识别技术栈(React、Next.js、Vue、SvelteKit 等)、检查 Playwright 是否已安装、查找已有测试目录与旧框架(Cypress、Selenium)测试、定位开发服务器命令与端口、识别主路由与认证流程、检查组件中的测试 ID、查找 API 路由与测试环境变量、检查 CI 配置与 Docker 设置。
  • 需求访谈:通过多轮提问明确关键用户流程、应用规模、认证方式、测试认证策略、测试数据管理方式、运行环境、CI 平台以及是否需要视觉回归测试。
  • 制定实施计划:涵盖目录结构、Playwright 配置(浏览器项目、base URL、重试、workers)、认证设置(storageState 或 API 认证)、页面对象、测试 fixtures、测试套件与 CI 配置。
  • 执行实现:按顺序生成 Playwright 配置、全局认证设置、自定义 fixtures、Page Object Model、测试套件、视觉回归测试与 GitHub Actions CI 工作流。

使用方式

技能按四个阶段推进:

  1. 探索(Plan Mode):在编写任何测试前,先分析项目结构、应用结构与 CI/CD 配置。
  2. 访谈(AskUserQuestion):分轮次澄清需求,包括关键流程、应用规模、认证类型、测试认证方式、测试数据管理、运行环境、CI 平台与视觉回归需求。
  3. 计划(ExitPlanMode):输出具体实施计划,涵盖目录结构、Playwright 配置、认证设置、页面对象、测试 fixtures、测试套件与 CI 配置,提交用户审批。
  4. 执行:审批后按步骤实现,依次生成 Playwright 配置、认证设置、自定义 fixtures、Page Object Model、测试套件、视觉回归测试与 CI 工作流。

适用场景

  • 在已有项目中首次引入 Playwright E2E 测试。
  • 为认证、核心 CRUD、结账/支付、仪表盘/管理等关键流程构建测试。
  • 需要可维护的测试架构(Page Object Model、自定义 fixtures)。
  • 需要跨测试复用登录状态(storageState 模式)。
  • 需要截图视觉回归测试。
  • 需要将 E2E 测试集成到 CI/CD 并支持分片与重试。

限制

资料未提供该技能的具体收费、价格、平台支持范围或实际运行效果等信息。技能的具体实现细节、依赖版本与兼容性要求暂未提供。