用途:证明 Prime 项目对 Figma 设计的视觉还原度,以确定性产物作为依据,由内置运行时判定通过或阻断,不能从构建成功、控制台干净、响应式截图或主观看图推断成功。
主要能力:程序化读取 Figma 测量值与浏览器页面的规范评估结果;对比对齐的 PNG 截图与媒体遮罩;运行审计脚本输出机器状态、得分与剩余违规项。
必要用法:确认目标路由本地可运行且 Figma 节点可访问;为每个被审计区块、文本、控件、图标、卡片和媒体槽添加稳定的 data-prime-audit-id、data-prime-audit-section、data-prime-audit-kind、data-prime-audit-role;创建 .primeui/temp/figma-to-prime/<run-id>/ 并阅读测量契约。运行:node <skill-directory>/scripts/run-audit.mjs --run-dir .primeui/temp/figma-to-prime/<run-id> --pass <1-5>。退出码 0 为机器通过,2 为有效阻断结果,1 表示审计无法运行并同样阻断一致性声明。以 audit.json 为权威,summary.md 为派生输出,二者不可手改。修正顺序为视口与画布、区块顺序与边界,排版与换行,网格轨道与间距,控件图标边框颜色,最后是未遮罩的装饰性位图差异;每次修正后须重新采集浏览器测量与渲染 PNG。
适用场景:需要在指定视口下验证布局一致性或完整视觉一致性时使用;layout-parity 要求除允许的位图内容外零机器违规,full-visual-parity 还要求无待处理遮罩且栅格审计通过。
限制:若无法获得精确 Figma 测量或浏览器页面评估则阻断,不能用截图估算或文字替代;pixel-perfect 仅指该视口下通过的整体视觉审计,不等于构建成功;没有 Figma 参考的响应式宽度只属普通响应式验收。审计在通过、第五轮后或修正循环停滞时停止,后两种仍为阻断并须报告精确违规。需报告运行目录、轮次、机器状态、得分、剩余违规、遮罩媒体、叠加与差异路径、浏览器视口及独立构建/交互结果。