用途:把运行中的 UI 与 Figma 活文档(Inventory + Spec)逐行比对,测量实际布局帧,将结论写入 Verify 区(或 Spec 源的同级报告)。非通过行需在本轮修复并重测。实际值必须来自真实布局读取,不得覆盖 Figma 期望值,也不得修改 figma-pixel-implement 技能文本。
主要能力:按行给出 PASS、DRIFT、HARDCODED、VARIANT、MISSING-style、accepted-residual 等判定;支持多主题与多视觉状态分别测量;可引用组件测试结果作为辅助证据;报告需含覆盖度、测量通道声明、Mounted in、Measurement command、Screenshot 及测量摘录代码块。
使用方式:先做预检,按阶梯选择测量通道——活文档 Stories 子节的故事 → 检测到的组件工作台 → 产品内预览路由 → 完整应用启动(最后手段);无 computed-style API 时用 layout-probe,即本轮执行命令,把控件挂载到出货父容器中跑一次布局并打印宽高与子帧。仅布局控件而不挂载父容器的命令不算测量。可打开 UI 的通道需保存本轮 png/jpg/jpeg/webp 截图并引用路径;无法打开 UI 的 layout-probe 记 Screenshot: not-openable。随后逐行切换状态与主题,读取计算样式或边界框,按容差比较,非通过则修复重测,安全上限约 8 轮。报告前运行 scripts/check-figma-verify-report.mjs,需退出码 0。
适用场景:figma-pixel-implement 之后,或用户要求检查像素对齐、设计还原度、对照稿面验收;独立使用时需用户提供 Figma URL 与运行预览 URL/路由,并按 implement 的路径约定持久化最小 inventory + spec。
限制:仅凭截图或视觉比较不能给出 Overall PASS;未测量的关键视觉行会阻塞通过;不得用源码字面量冒充实测值;不得把行为行当作像素 PASS;不得为无法打开 UI 的探针编造图片;不得把第三方浏览器 API 复制进本技能;ego-browser 缺失不中止验收,但需记录所用通道。具体容差、模板与命令细节见 reference.md,资料未提供其内容。