用途:为 UI/UX 交付提供统一标准与验证协议,确保界面任务在标记完成前达到可交付质量。
主要能力与检查项:
- 视觉验证:用 playwright-cli 打开页面,分别在移动端 375x812、平板 768x1024、桌面 1440x900 断点截图(--full-page),存入 qa-screenshots 目录。若无 playwright-cli,可用标准 Playwright:npx playwright <command>。
- 控制台错误检查:执行 playwright-cli console error,要求应用代码零错误(含 console.error、未捕获异常、4xx/5xx 失败请求);第三方警告可记录但不禁用,已知不可消除错误需登记到 /docs/known-console-errors.md。
- 构建验证:如 React/Vite 项目执行 npm run build,须无错误。
- 无障碍检查:node scripts/run-axe.mjs <path>,要求零严重/关键违规,覆盖颜色对比度(WCAG AA)、交互元素 ARIA 标签、键盘导航、焦点指示。
- QA 门禁:node scripts/qa-gate.mjs <path> ui,退出码 0 为 PASS,1 为 REVISE,2 为 REJECT。
- 对抗性审查:node scripts/adversarial-review.mjs <deliverable> ui,需 PASS 或 REVISE;80-100 分 PASS,70-79 REVISE,0-69 REJECT。
交付清单:三档截图(按 [ticket]-[breakpoint].png 命名,存 ./qa-screenshots/[date]/)、应用控制台零错误、无严重无障碍违规、构建通过、QA 门禁退出 0、对抗性审查 PASS 或 REVISE。产物须附到 PR 或共享存储。
完成消息模板包含截图路径、质量检查结果、交付文件、日志与备注。缺少截图、控制台有错、构建失败、QA 门禁拦截或对抗性审查 REJECT 时不得交付。若卡住可自行修复最多 30 分钟,仍无法解决则用 ./notify-maria.sh 通知并附具体错误。
限制:资料为强制性流程规范,未提供收费、价格或适用平台信息。