设计验收（全量）

对比 设计工具基准（Figma / MasterGo / Pixso / 即时设计等）与 开发实现（截图 + URL），按 Notion《验收全量检测内容清单》 三维度加权验收，输出计分与标注报告。

权威规则：rules-reference.md（Notion 定稿 + PDF）。计分：scoring-algorithm.md。

必读参考

推荐输入

工作流

Task Progress:
- [ ] 0. 读 acceptance-guardrails.md 开验前清单
- [ ] 1. 设计链接 → design-baseline.json
- [ ] 2. 路由/端型/采图（H5：/app/ + iPhone UA + CDP clip）
- [ ] 3. 视觉 L1/L2/L3（V-* 全量）
- [ ] 4. 交互走查（I-*，需 URL）→ interaction-checklist.md
- [ ] 5. 适配走查（A-*）→ adaptation-checklist.md
- [ ] 6. 极端场景 → extreme-scenarios.md + risk-acceptance.json
- [ ] 7. 三维度计分 + checkpoint_ledger（~51 行 V/I/A）
- [ ] 8. HTML 报告 + annotated-dev.png

Step 0–3：视觉（保留原流程）

1. 识别平台 → DSL → design-baseline.json（含 source_tool）
2. 视口对齐：dev 与 frame 误差 ≤2%，否则 L2 px 标 untested
3. 按 full-checkpoint-checklist.md 走查 V-*（编码可用 VA-*，报告归一化为 V-*）
4. 每条 visual fail 须 bbox_px；design 引 DSL

id: F-003
checkpoint_code: V-COLOR-BRAND
dimension: visual
severity: general
deduction: 2
bbox_px: [545, 162, 78, 16]
design: "Token brand-warning #F5A623"
actual: "截图取样 #1890FF"
verified_by: mastergo_dsl

Step 4：交互验收

见 interaction-checklist.md。无 URL 时 I-* 标 untested + note，禁止猜扣分。

Step 5：适配验收

见 adaptation-checklist.md。多视口/深色/Lighthouse。

Step 6：极端场景

见 extreme-scenarios.md。产出 risk-acceptance.json。

Step 7：计分

scripts/va_utils.py → build_scores_payload(ledger, findings)。ledger 每个 V/I/A 一行。

Step 8：HTML 报告

SKILL="${VA_SKILL_ROOT:-.}"
OUT=reports/design-acceptance--

python3 "$SKILL/scripts/generate-report.py" 
  --dir "$OUT" 
  --title "<页面>设计验收" 
  --meta "375×812 · H5 · $(date +%F)" 
  --dev dev.png 
  --baseline design-baseline.json 
  --findings findings.json 
  --ledger checkpoint-ledger.json

python3 "$SKILL/scripts/bake-annotations.py" 
  "$OUT/dev.png" "$OUT/findings.json" -o "$OUT/annotated-dev.png"

与 design-fidelity-audit 区分

详见 fidelity-audit-migration.md。

输出检查

• 已执行 acceptance-guardrails.md 开验前清单
• design-baseline.json + report-meta.json
• 全部 V/I/A checkpoint 有 pass/fail/na/untested
• visual fail 均有 bbox_px；design 引 DSL
• scores.json 含 visual/interaction/adaptation/total/grade/veto_applied
• HTML：三维度分 + 分维 ledger + 极端场景附录（如有）