用途:把录制文件、规格文档或代码变更转化为可维护、可追溯到规格的 E2E 测试,使测试只在预期业务行为被破坏时失败,而不因界面外观变动而失败。
主要能力:按顺序检测项目所用 E2E 框架(Playwright、Selenium、Cypress 等);读取 docs/project-reference/e2e-test-reference.md 与 docs/project-config.json 的 e2eTesting 配置;从 docs/specs/ 加载 TC-{MODULE}-E2E-{NNN} 规格;在写测试前通过真实场景保真度门禁;用 Page Object Model 生成或更新测试;用项目配置命令运行测试;把经验回写到参考文档。支持 from-recording、update-ui、from-changes、from-spec 四种模式。
使用方式:先执行 head -100 docs/project-reference/e2e-test-reference.md、grep -A 50 '"e2eTesting"' docs/project-config.json、grep -r "TC-.*-E2E-" docs/specs/ 获取约定与 TC 编码;生成与基线更新需通过 e2e-runner 子代理执行;未处于工作流时需先询问用户是否启用 e2e --source=changes 工作流或直接执行 $e2e-test。
规则与限制:每个测试须带 TC 编码并关联所守护的规格行为;选择器优先级为语义/BEM、data-testid、ARIA/role、可见文本,避免生成类名、:nth-child 与 XPath;测试数据须唯一自足,不依赖既有数据库状态,也不清理种子数据;断言不得为求通过而放宽或重试;真实场景保真度门禁要求模拟真实节奏并等待可观察信号,而非盲目 sleep。资料未提供具体框架版本、收费与平台支持信息。