SuperAPI AI 工具集

flow-walk

测试与质量

查看项目

更新于 10-15 21:41

技能介绍

用途:按流程定义逐步执行用户流程,使用 Playwright CDP 驱动浏览器,在每一步截图、计时并记录结果,最终生成可嵌入 issue/PR 的可视化证据。

主要能力:支持 navigate、click、fill、select、scroll、wait、hover 等步骤动作;优先连接已开启 CDP 的 Chrome(端口 9222),否则启动无头 Chromium;解析 .flowchad/flows/{name}.yml 中的步骤与环境变量;对每步截图并记录耗时,按阈值标记 slow;用自然语言 expect 判断预期是否满足,记录 pass/fail/error;出错时截图并继续后续步骤;支持 optional 与 captcha 步骤的特殊处理。

录制与输出:可录制视频,基于动作日志智能裁剪无操作片段,生成 {flow-name}-full.webm、{flow-name}-trimmed.mp4 和调色板优化的 {flow-name}.gif;结果写入 .flowchad/snapshots/{日期}-{flow-name}/results.json,包含步骤状态、耗时、截图、视频信息、动作日志与汇总统计。

使用方式:命令为 /flow-walk <flow-name>,参数对应 flows/{name}.yml。前置条件包括启用 CDP 的 Chromium/Chrome 或可启动无头浏览器、安装 playwright-core、存在流程定义文件。证据上传默认使用 git 后端,失败仅告警不阻断。

适用场景:注册、登录、结账等用户流程的走查与回归验证,生成可分享的 GIF/视频证据。

限制:captcha 步骤需有头浏览器(Navvi)并标记 skipped;证据上传为尽力而为;具体配置项与脚本路径以实际项目为准,资料未提供更多细节。