用途:作为浏览器 QA 流程编排器,依据 qa/browser-flows 中的流程规范在真实浏览器内执行测试,并生成 JSON 报告与配套 Markdown 摘要。
主要能力:支持 --list 列出流程(id、标题、group、priority、resources);支持 --all 运行全部流程;--only=flow-a,flow-b 仅运行指定流程;--group=<name> 按 group 过滤;--parallel 与 --max-parallel=3 控制并行;--base-url=<url> 指定被测 Inbox Zero 应用地址。默认只运行 priority: high 的流程,低优先级被跳过。并行时要求批次内无重叠资源、无 conflicts_with 冲突,且每个流程 parallel_safe 为 true,否则改为顺序执行。报告写入 qa/browser-flows/results/<run-id>.json,截图存于同目录子文件夹,摘要写入 <run-id>.md。
使用方式:命令形如 /qa-run --all [--parallel] [--max-parallel=3]、/qa-run --only=flow-a,flow-b、/qa-run --group=api、/qa-run --all --base-url=http://localhost:3000。未提供 --base-url 时须先询问用户要测试的 URL,不得默认生产或本地地址;Gmail/Outlook 地址不受该参数影响。运行前需阅读 qa/browser-flows/README.md 与选定流程文件,按流程规范原样执行,跨 Gmail、Outlook 与 Inbox Zero 切换时使用有意的等待,失败流程至少截一张图并写入报告。
限制:不虚构步骤,不修改无关设置;报告不得含密钥,敏感值用占位符;因缺少登录或环境问题被阻塞的流程标记为失败并说明原因;流程失败需指明失败步骤与原因;除非失败导致无法清理,否则需执行 Cleanup 步骤。