用途：像真实用户一样对整仓库做系统化 QA，先发现仓库的验证与 E2E 契约，再执行构建、lint、测试、启动等命令，覆盖 CLI、API 与 Web UI 流程，最后产出问题单、截图与验证报告。
主要能力：支持可选参数 qa-output-path 指定产物目录，未提供时回退到仓库约定或 /tmp/codex-qa-<slug>，并在其下创建 qa/ 子目录存放 issues、screenshots、verification-report。通过 python3 scripts/discover-project-contract.py --root . 发现安装、验证、构建、测试、lint、启动命令及 Web UI、E2E 信号；优先使用 make verify、just verify 等仓库级命令。可读取 references/project-signals.md、references/e2e-coverage.md、references/checklist.md、references/web-ui-qa.md 辅助判断。
使用方式：先建立基线（按 lint/类型检查、构建、单测、集成测试顺序），再执行 CLI 与 API 流程，随后用 agent-browser CLI 执行 Web UI 流程，核心循环为 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。修复回归后重跑窄复现、自动化覆盖、受影响场景与基线门禁，最后用 assets/verification-report-template.md 写报告，必填字段含 Claim、Command、Executed timestamp、Exit code、Output summary、Warnings、Errors、Verdict 及 Automated Coverage 部分。
适用场景：需要端到端验证改动面与回归关键路径、需要浏览器级证据、需要区分 existing-e2e、needs-e2e、manual-only、blocked 的项目。
限制：不编造命令；agent-browser 未安装或开发服务器启动失败时跳过 Web UI 流程并记录阻塞；仓库无 E2E 框架时不在 QA 期间新建框架；缺少凭据或运行时服务时保留 blocked 分类并报告缺失前置条件；不得在无最新验证证据时声称完成。