用途:对公开 URL、本地页面或运行中的 Web 应用执行一次聚焦、可产出证据的浏览器 QA 检查,用于快速确认、评审证明和可执行的缺陷报告,而非完整无障碍认证、跨浏览器覆盖或 CI 替代。
主要能力:检查控制台错误与失败请求、损坏图片/资源、主导航或 CTA 的键盘/焦点冒烟测试、16:9 视口可读性(裁切、溢出、正文不可读),可选无障碍/内容冒烟检查(缺少明显标题、图片缺 alt、无主内容)。结果按 pass、warn、fail、unknown 分类,非 pass 项必须附证据。
使用方式:先加载 agent-browser 技能确认浏览器自动化可用。用命名会话运行,例如 agent-browser --session browser-qa-<run-id> open <target-url>;在 about:blank 时先清空缓冲区:agent-browser --session "$SESSION" console --clear、errors --clear、network requests --clear,再打开目标并 wait --load networkidle,走关键路径后收集 agent-browser errors --json、console --json、network requests --json。报告存于系统临时目录 /tmp/browser-qa-reports/<run-id>/,含 findings.json 与截图;用 uv run skills/browser-qa/scripts/validate-findings.py 校验 JSON。报告查看器由 uv run skills/browser-qa/scripts/serve-report.py --port 10891 启动,先探测 http://127.0.0.1:10891/api/reports,已运行则不重启,最终给出 http://127.0.0.1:10891/?report=<run-id>。可选启动 agent-browser dashboard start(默认 http://localhost:4848)观察会话。结束前关闭任务会话:agent-browser --session browser-qa-<run-id> close,并用 agent-browser session list 确认清理。
适用场景:验证页面、本地 HTML、UI 变更或关键浏览器路径;为浏览器可见缺陷采集证据;生成结构化发现与本地报告链接。
限制:不用于负载测试或性能基准、广泛跨浏览器/设备认证、完整 WCAG 合规审计,也不替代 CI 中的单元、集成或端到端测试。自动化无法证明的结果应保留 unknown,避免夸大覆盖范围。