用途:/qa-engineer 是部署后的浏览器级 E2E 门禁。它面向已部署到 dev、stg、audit 或 prod 环境的变更,驱动真实浏览器走通用户流程,验证前端、反向代理、真实会话等链路,弥补本地 curl 检查的不足。
主要能力:针对已部署 URL 运行 Playwright 浏览器 E2E;按 explore.md 契约与 work.md 变更派生 UI 流程;每个流程生成 happy、boundary、negative 变体,并配 smoke.spec.ts 关键路径;产出 trace.zip、video.webm、逐步截图、console.log、network.har 等证据;同票重复调用时对已有规范做最小差异更新而非重写。
使用方式:先由 /explore、/work、/verify 产出文档,/verify 状态为 pass 且变更已部署后调用。运行前需明确环境并做安全预检,拒绝 localhost 目标,prod 默认只读且写操作需逐步授权。典型命令:在 .backend/<YYYYMM>/<slug>/e2e 下执行 QA_ENV=dev npx playwright test --config=playwright.config.ts --reporter=html,json --output=artifacts/run-<YYYYMMDD-HHMM>-<env>。产物含 _env.sh、storageState.json、specs、artifacts 与 qa.md。无票目录时可进入 standalone 模式。
适用场景:部署后验收、prod 部署后冒烟、回归复现、临时浏览器 QA。
限制:localhost 验证归 /verify;纯后端 Feign 变更、无用户可见流程的配置变更、纯文档提交可跳过;无 trace、无视频或来自 localhost 的运行不算通过;认证状态需脱敏,禁止写入真实个人信息;环境地址、账号凭据、收费标准等资料未提供。