SuperAPI AI 工具集

product-design-design-qa

设计与创作

查看项目

更新于 10-16 04:58

技能介绍

用途:这是一个内部原型 QA 辅助技能,用于在交付(handoff)前把原型的源设计与已渲染实现进行视觉对比。不适用于宽泛的 UX 评审、设计批评、产品审计或流程评审,这些应改用 audit。应在每次 Product Design 构建交付前使用。

前提:一次通过的 QA 需要同时具备源视觉目标(Figma 节点、图片、截图、mockup 或源捕获)与已渲染实现(本地 URL、已部署 URL、应用界面、组件或截图)。如果任一产物无法打开、捕获或对比,需在 design-qa.md 中写明 final result: blocked 并指出阻塞项,不得让构建技能以完成状态交付。

工作流程:先确定对比目标并统一视口、状态、主题、设备密度、路由、内容、鉴权和交互状态,状态不一致需先说明。然后捕获证据:Figma 用设计上下文与截图工具,Web/应用在目标视口截图,必要时补充移动/桌面、hover/focus/active、空/加载/错误、深色/浅色及响应式断点等状态。必须把源图与实现截图放入同一对比输入后再判断,不能凭记忆、代码或文件路径写评审,也不能把独立图片视图当作并排对比。归一化裁剪、视口、缩放与设备边框后再比较,优先比较内容区域而非浏览器外框。整体视图用于判断构图、层级、布局、密度与响应式结构;细节过小时使用聚焦区域对比。若无需聚焦区域,需说明原因。

评审要点:系统性检查信息架构、布局、间距、字体排印、颜色、图像质量、图标、文案、可供性、交互状态、响应式、可访问性与打磨度。必须覆盖五个必需保真面:字体/排印、间距/布局节奏、颜色/令牌、图像质量与资产保真、应用专有文案内容。若源稿未涵盖所发现的问题(如空状态),应作为源稿不足的独立发现列出。同时判断实现是否与 mock 一样好,指出风格问题;若用户提示词泄漏进实现,也应指出。区分设计漂移与有意的产品或代码约束,可能有意为之的偏差以问题或假设形式表述。

图像资产保真:若视觉目标中的 logo、插画、装饰标记、产品图、非标准图标等可见图像资产被自定义内联 SVG、手工 SVG、HTML 元素、div/span 形状、CSS 绘制、渐变、emoji、文字字形、占位形状或代码原生近似替代,直接判 QA 失败。

严重级别:P0 阻断核心使用、严重可访问性失败、布局损坏或任务不可完成;P1 用户易察觉的重大设计不匹配或可用性退化;P2 中等视觉漂移、状态不一致、响应式问题或可修复的打磨缺口;P3 提升保真但不阻断验收的细节优化。

输出格式:Findings(每条含严重级别、位置、差异证据、影响、具体修复)、Open Questions、Implementation Checklist、Follow-up Polish。无实质不匹配应明确说明并列出残余测试缺口。交付前使用时将最新报告保存为项目根目录 design-qa.md,需包含源视觉路径、实现截图路径、视口、状态、整体视图对比证据、聚焦区域对比证据或未使用原因、发现、上次 QA 后的补丁、最终结果。final result 只能是 passed 或 blocked:无待处理 P0/P1/P2 时为 passed,P3 可留作后续打磨;仍存在待处理 P0/P1/P2 时为 blocked 并指出阻塞项。最后返回 QA 报告的文件路径。

限制:本技能仅用于内部原型的视觉保真对比,不替代面向用户的审计或设计批评;对比所需任一产物缺失时只能标记 blocked,无法给出通过结论。