visual-qa 是一套面向本地 SPA 的闭环视觉自检工作流，用三层独立校验替代“智能体自己看图就宣布通过”的做法：基线像素对比（机器）、页内不变量断言（机器）、按评分表逐张读图（人/智能体），三者都干净且有截图证据才算通过。
用途与触发场景：刚改主题、UI 或重品牌后，确认有没有非预期的破坏；需要为带 UI 的变更设验收门禁；浏览器扩展无法截取 localhost 时改用无头命令行；用户提到视觉 QA、逐路由截图、基线对比、界面回归等。
主要能力：在 localhost 运行无头浏览器；测量计算样式与元素矩形；与基线逐像素对比（默认阈值 0）；执行不变量检查，如 contrast-aa、monochrome-surface、rogue-slab、shadow-clipped、overlap、row-misalign；生成截图、MANIFEST.json 与 FINDINGS.md；支持 --assert 以退出码充当验收门禁。
使用方式：应用需先运行，路由与主题列表须取自应用本身，而不是猜测。安装依赖：npm i --prefix skills/visual-qa/assets。典型命令：
node skills/visual-qa/assets/route-shots.mjs
--base http://localhost:5230 --out <dir>/qa-shots
--baseline <dir>/qa-baseline
--user demo --pass demo --assert
常用参数包括 --route、--assert、--baseline、--update-baseline、--diff-threshold。
限制与失败边界：登录失败时 --assert 立即失败，不审计登录页副本；缺少 playwright-core 会在 import 处阻塞；基线差异不为 0 时需人工查看后用 --update-baseline 批准；用户报错而机器显示干净时，应复现用户状态再下结论，无法复现就直说；只读部分截图不算完成。资料未提供价格、平台支持范围和效果保证等信息。