Visual QA 是一个轻量级的可视化冒烟测试检查点,用于验证面向 UI 的改动。它通过快速冒烟流程、截图以及控制台/网络检查,确认扩展或后端的界面变更是否正常,并将结果写入 .checkpoints/visual-qa.json。
用途:在合并到 main 分支后,由 conductor 对 UI 相关改动执行一次快速可视化验证。
主要能力:检测 UI 相关文件变更(extension/ 目录下文件,或 .css、.tsx、*.jsx);若无此类改动则直接判定 PASS(跳过)。否则执行快速冒烟测试并记录 PASS/FAIL。支持通过 Tabz MCP 获取控制台日志、截图、启用网络捕获并读取网络请求。
使用方式:先检测变更,命令为 git diff --name-only main...HEAD 等;若命中 UI 文件则 NEEDS_VISUAL=1。浏览器操作前必须创建独立标签组,例如 SESSION_ID="Claude-$(shuf -i 100-999 -n 1)",再调用 mcp-cli call tabz/tabz_create_group 创建组,并用返回的 groupId 打开 URL。所有操作必须显式传入 tabId,不能依赖活动标签页。随后打开扩展侧边栏、触发受影响 UI 路径、检查控制台错误并截图。最后用 mkdir -p .checkpoints 与 cat > .checkpoints/visual-qa.json 写入检查点文件。
适用场景:扩展或应用的 UI 改动合并到 main 后的可视化验证。
限制:不应由 git worktree 上的 Worker 运行,因为改动未构建、浏览器实例共享、标签组冲突、开发服务器端口冲突。正确流程是 Worker 提交改动、conductor 合并到 main、重新构建扩展/应用,再在 main 分支运行 /conductor:visual-qa。若没有 Tabz MCP,则需手动检查并注明。其他收费、平台等信息暂未提供。