全量设计验收检测

要解决什么问题

设计稿在 Figma、MasterGo、Pixso 或即时设计里定稿后，开发落地常见两类落差：像素级视觉（间距、字号、颜色）和 交互/适配（悬停、多视口、深色模式）。口头「差不多」或只靠肉眼扫两张图，很难覆盖 Notion《验收全量检测内容清单》里的检查点，也无法给出可归档的扣分依据。

本技能面向有设计链接的正式验收：把设计工具 DSL 当作基准，对照开发截图（必填）与可选的开发 URL，按 V（视觉）/ I（交互）/ A（适配） 三维度走查，并处理极端场景分层，最后输出计分与带 bbox_px 的标注报告。

如何工作

工作流在保留原视觉流程（Step 0–3）之上，扩展交互、适配与计分：

1. 识别平台并拉 baseline：根据设计稿链接生成 design-baseline.json（含 source_tool），视口与 frame 对齐；若 dev 与 frame 宽度误差 >2%，相关项标为 untested（L2 px），不硬判 fail。
2. 全量检查点：按 full-checkpoint-checklist.md 走查 V-*；每条 visual fail 必须有 bbox_px，设计侧引用 DSL。交互见 interaction-checklist.md，适配见 adaptation-checklist.md。
3. 计分与报告：scripts/va_utils.py 的 build_scores_payload(ledger, findings) 生成 scores.json（含 visual/interaction/adaptation/total/grade/veto_applied）；再按 report-generation.md 产出 HTML，含三维度分、分维 ledger 与极端场景附录。

权威规则在 rules-reference.md 与 scoring-algorithm.md；开验前须执行 acceptance-guardrails.md，避免无 URL 时对 I-* 猜扣分（应标 untested + note）。

适用边界

| 场景 | 建议 |
|------|------|
| 有 Figma/MasterGo 链接 + 同宽 PNG | 本技能（全量） |
| 只有两张截图、快速扫一眼 | 用 design-fidelity-audit，弱 DSL/MCP |

无开发 URL 时，交互与 Lighthouse/CDP 类检查会大量 untested，报告仍应完整列出各 checkpoint 的 pass/fail/na/untested 状态，而不是省略维度。