用途：对项目做系统化 QA，按真实用户路径验证仓库的构建、lint、测试、启动及端到端流程，产出可追溯的验证证据。
主要能力：先读取根指令、仓库文档与 CI/构建文件，运行 python3 scripts/discover-project-contract.py --root . 发现安装、验证、构建、测试、lint、启动命令及 Web UI、E2E 信号；优先使用 make verify、just verify 等仓库级命令。随后建立基线（按 lint/类型检查、构建、单测、集成测试顺序），再执行 CLI/API 流程与 Web UI 流程。Web UI 使用 agent-browser CLI，核心循环为 open、snapshot、interact、re-snapshot、verify，可用命令限于 open、back、forward、reload、snapshot -i、click @ref、fill @ref "text"、select @ref "value"、press Key、check @ref、uncheck @ref、wait、get text @ref、get url、get title、screenshot、state save、state load、close。
使用方式：可选参数 qa-output-path 指定产物目录，未提供时按仓库约定或回退到 /tmp/codex-qa-<slug>，所有问题、截图、报告存于 <qa-output-path>/qa/。问题文件按 BUG-<num>.md 命名，标注 Severity 与 Priority；最终用 assets/verification-report-template.md 生成 verification-report.md，含 Claim、Command、Executed、Exit code、Output summary、Warnings、Errors、Verdict 及自动化覆盖与浏览器证据。
适用场景：需要整仓库回归验证、变更面与关键业务流验证、Web UI 关键用户流测试、E2E 覆盖评估与回归修复验证的项目。
限制：不编造命令，agent-browser 命令不得超出给定集合；仓库无 E2E 框架时不在 QA 中新建；缺少凭据或运行时服务时相关流程标记为 blocked；agent-browser 未安装或开发服务器启动失败时跳过 Web UI 流程并记录阻塞；不得在无最新验证证据时声称完成。