SuperAPI AI 工具集

e2e-flow-verifier

通用与其它

查看项目

更新于 10-16 03:48

技能介绍

用途:以 qe-browser 技能(Vibium 引擎)驱动完整用户流程,逐步断言状态,并记录截图与 DOM 快照组成的 ZIP 证据,用于产品验证与 CI 门禁。

主要能力:将流程定义为 JSON 批量计划,由 qe-browser 批量运行器执行;支持 go、wait_load、fill、click、wait_url、assert 等动作,断言类型包括 url_contains、selector_visible、text_visible、no_console_errors、no_failed_requests、response_status、request_url_seen、element_count、value_equals 等。批量运行器任一步失败即返回非零退出码,便于 CI 用 $? 判断。

使用方式:激活命令为 /e2e-flow-verifier [flow-name]。依赖 .claude/skills/qe-browser/,vibium 二进制由 aqe init 自动安装。典型流程:先写 flows/{{flow-name}}.json 批量计划,再执行 vibium record start --screenshots --snapshots --name "{{flow-name}}",随后运行 node .claude/skills/qe-browser/scripts/batch.js --steps "@/tmp/{{flow-name}}.json",最后 vibium record stop -o "test-results/{{flow-name}}/evidence.zip"。需要独立 HAR 1.2 网络日志时使用 vibium har-export。跨运行复用登录态可用 vibium storage -o 保存、vibium storage restore 恢复。

证据内容:ZIP 包含每个动作的截图与失败标注截图、交互前后 DOM 快照、带 URL 与时序的事件时间线、内联捕获的控制台与网络日志。

适用场景:注册、购买、资料编辑、搜索等常见流程验证。

限制与注意事项:Vibium @e1 引用在导航后失效,需用 vibium diff map 重新映射;选择器优先 data-testid;认证令牌会过期,需每次新登录或轮换存储快照;证据 ZIP 会增长,CI 中建议仅保留失败运行并定期清理;本技能不再使用 @playwright/test,如需 Playwright 网络拦截应放在独立技能中作为步骤调用。