RYUX Visual QA 是 ryuxdsgn/design-intelligence 中的视觉质量检查技能,属于 Quality 分组、Delivery Gate 的 VISUAL QA 领域(RX-2.0)。它只回答一个问题:实现是否匹配预期设计。设计本身是否优秀由 ryux-critique(Critique)负责,不在本技能范围内。
用途:在视觉实现完成后,对构建结果做系统的视觉验收,识别与设计稿或预期之间的偏差,并推动修复。
主要能力与做法:
- 有参考时(Figma 或 pen.dev 画框、DESIGN.md、已批准的截图):在同一视口截取参考与实现,逐属性对比间距、字体、颜色、尺寸、位置、组件、状态和响应式行为,并按表格形式报告每处偏差,包含区域、期望值(参考)、实际值(构建)、偏差描述、严重程度和修复建议。
- 无参考时:依据构建自身的意图和技能规则进行检查。
- 循环流程:实现 → 渲染 → 对比 → 修复 → 再渲染。
- 渲染方式按可用性依次为:项目自带的预览或测试环境;npx playwright screenshot --viewport-size=1440,900 <url>(移动端 390 宽);浏览器工具;pen.dev Export 等设计工具导出。若均不可用,需在验收报告中说明。
- 按影响排序问题:阻断任务、误导(错误数字、不明确操作)、增加摩擦、打磨项,并从高优先级开始修复。
证据来源:预期设计(Figma、pen.dev、DESIGN.md)是参考基准;RYUX 屏幕是次要对比对象,可通过 search_screens 检索。若没有 ryux MCP,需说明证据仅来自设计和标准。
硬性门槛(不论加载哪些技能都适用):不得编造数字、人物、紧迫感、业务规则或术语;不得将占位内容作为最终结果交付;不得缺少关键状态。详见 ryux-core。
主要规则:
- RX-QA-01(必需)渲染、检查、修复、再渲染:在目标视口渲染结果,检查主状态、一个空或错误状态以及最小支持宽度,按影响排序并从顶部修复,再渲染;无渲染工具时在报告中说明。禁止仅凭代码宣称视觉质量,或未经检查结果就凭猜测修复。
- RX-QA-03(必需)文字不得被遮挡或碰撞:浮动卡片和模型只放在空白区域,导航项避开 logo 和按钮;不得让卡片盖住价格或标签,不得让导航项相互接触。
- RX-QA-04(必需)数字一致:行项目相加应等于小计和总计,同一数值在屏幕各处显示方式一致;不得展示互相矛盾的示例数字。
- RX-QA-06(推荐)匹配预期设计:有参考时在同一视口截取参考与构建,对比间距、字体、颜色、尺寸、位置、组件、状态和响应式行为,列出每处偏差及修复;无参考时至少与一个参考 screen_id 对比。不得在构建明显偏离设计时未说明就称完成,也不得只与自身对比评判。
适用场景:前端页面或组件实现完成后的交付前视觉验收、设计稿还原度检查、响应式布局检查、上线前的视觉质量把关。
限制:技能本身不评估设计好坏;需要可用的渲染或截图工具才能完成完整检查;依赖参考设计或 RYUX 屏幕证据;未提供具体安装命令、收费模式或价格信息,暂未提供;具体工具集成细节(如 npx playwright screenshot --viewport-size=1440,900 <url> 之外的环境要求)暂未提供。