name: design-acceptance-check description: 通过 Figma、MasterGo 等设计稿链接与开发截图/URL，按 Notion《验收全量检测内容清单》三维度加权验收（视觉40%+交互35%+适配25%），DSL 基准、V/I/A 全量检查点、bbox 标注与极端场景附录，输出 HTML 报告。Use when the user mentions 设计验收、视觉验收、三维度、交互验收、适配验收、极端场景、Figma、MasterGo、全量检查点、验收报告。

设计验收（全量）

7w4.net收录了海量优质技能插件。

对比 设计工具基准（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-<page>-<timestamp>

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 + 极端场景附录（如有）

这个 Skill 质量扎实，文档非常详细，验收规则清晰，扣分机制设计合理，能有效避免误判。支持对比设计稿和开发实现，自动生成带评分的 HTML 报告。不足之处是配置文件命名有个小问题，以及部分文档较长、较专业，新手需要花时间消化。总体推荐使用。