用途:Design QA 是内部原型质量检查助手,用于在交付前把原型的源设计与渲染实现进行对比。它面向产品设计原型、URL 转代码或图片转代码构建,不用于宽泛的 UX 批评、设计评审、产品审计或流程审查(这些应使用 audit)。每次产品设计构建交付前都应使用。
主要能力:要求同时具备源视觉目标(Figma 节点、图片、截图、设计稿或源捕获)和渲染实现(本地 URL、已部署 URL、应用界面、组件或截图);若任一无法打开、捕获或对比,则写入 design-qa.md 并将最终结果标记为 blocked 并说明阻塞原因。以产品级质量评审者身份对比,输出基于双方证据的优先修复清单。必须把源图与实现截图放入同一对比输入,不能仅凭记忆、代码或文件路径撰写评审。
使用方式:先确定对比目标并匹配相同视口、状态、主题、设备密度、路由、内容、认证与交互状态;捕获证据(Figma 用设计上下文与截图工具;移动应用模板用 data-testid="device-screen" / [data-phone-screen],仅当源视觉含设备边框时用 data-testid="phone-frame";捕获前运行 npm run check:runtime,失败视为阻塞);归一化裁剪、视口、缩放与设备边框;先做全视图对比,再按需做聚焦区域对比;系统检查信息架构、布局、间距、字体、颜色、图像、图标、文案、可供性、交互状态、响应式、无障碍与打磨,并始终覆盖五项必需保真面:字体排版、间距布局节奏、颜色令牌、图像质量、文案内容。
限制:Design QA 是迭代循环,首次对比只有在未发现可操作的 P0/P1/P2 差异且未做视觉修复时才可通过;发现 P0/P1/P2 时须记录、修复、同视口同状态重新捕获并再次对比。构建、依赖、lint、部署与预览排障不计入设计 QA 迭代。若源或实现为 @2x 等高密度,需归一化后再比较,不得因密度不匹配、浏览器边框、画布留白或设备边框不匹配而提交视觉发现。若 logo、插画、装饰标记、产品图像、非标准图标等可见图像资产被替换为自定义内联 SVG、手绘 SVG、HTML 元素、div/span 形状、CSS 绘制、渐变、emoji、文本字形、占位形状或代码原生近似,则 QA 失败。最终结果必须为 passed 或 blocked;交付前将最新报告保存为项目根目录 design-qa.md,并返回该文件路径。