SuperAPI AI 工具集

create_e2e_tests

测试与质量

查看项目

更新于 10-16 01:14

技能介绍

用途:该技能用于以规格驱动方式创建端到端(E2E)测试。它强调在写测试前先做结构化规划,适用于从零创建本地测试项目、为 Web 应用添加 YAML 测试、为测试项目配置认证,以及先规划要测什么再动手。

主要能力:工作流分为五个阶段,每阶段产出 Markdown 工件并作为下一阶段输入。Discover 产出 test-strategy.md,理解应用与用户目标;Specify 产出 test-spec.md,用 Given/When/Then 定义测试场景并按风险分级(P0/P1/P2);Plan 产出 test-plan.md,确定文件结构、实现顺序与每个测试的指引;Implement 搭建项目并编写 *.test.yaml;Verify 做覆盖率检查并让规格与测试对齐。支持快速通道:若已有工件可复用并跳过相应阶段,用户明确要求时可只执行 Implement。

使用方式:先确定项目路径并创建 test-specs/ 目录。若设置了 SHIPLIGHT_API_TOKEN,可用 /cloud 技能获取环境与测试账号。搭建阶段调用 scaffold_project 生成 package.json、playwright.config.ts、.env.example、.gitignore 和 tests/,然后执行 npm install 与 npx playwright install chromium。运行测试使用 npx shiplight test --headed。运行 YAML 测试需要配置 AI 提供商(Google AI、Anthropic、OpenAI、Azure OpenAI、AWS Bedrock 或 Google Vertex AI),将 API 密钥写入 .env,必要时用 WEB_AGENT_MODEL 覆盖默认模型。认证按标准 Playwright 模式配置,凭据以变量形式写入 playwright.config.ts,敏感值用 { value, sensitive: true }。

编写测试要点:不要凭想象写 YAML,需先在浏览器会话中走查流程并用 inspect_page、act、get_locators 捕获真实定位器,再用 validate_yaml_test 校验定位器覆盖率(最低 50%)。ACTION 为默认语句类型,DRAFT 仅作最后手段,断言用 VERIFY,导航用 URL,脚本用 CODE。intent 字段描述用户目标而非 DOM 元素,以便自愈。等待可用 WAIT_UNTIL(默认 60 秒)或固定时长 WAIT。

限制:资料未提供价格、平台支持范围、性能指标等细节;测试失败时需分类为实现问题或规格不符并升级给用户,不应静默重试。