ui-check

解决什么问题 · Problem

「UI 看起来不太对」既没有证据也没有标准。ui-check 立了三条规矩:

一、结论必须来自真实渲染证据——截图加 DOM 几何与计算样式度量,光看截图「觉得不对」只是假设;二、评判基准是项目自己的设计语言(显式规范,或从成熟界面推导的惯例,推导规则需至少两个独立界面重复出现),不凭品味、不引入流行风格;三、发现问题只做 A/B 证据演示,改不改由用户在验收包里逐条决定,用户拒绝的项绝不实施。

怎么用 · How to use

先建立隔离的审计工作区(SKILL.md 中的真实命令):

python3 scripts/init_audit.py --output-dir <dir> \
  --audit-id <id> --scope "<scope>" --tier <tier>

然后按阶段走:建立 UI 基线 → 清点屏幕 / 状态 / 环境并声明覆盖计划 → 真实走查逐格截图 → 按 SPEC / POLISH / EDGE / OPT 四类分类 → 独立复审 → 生成验收包:

python3 scripts/validate_audit_manifest.py <manifest>   # 必须打印 VALID
python3 scripts/build_acceptance_demo.py --input <manifest> \
  --output acceptance/ui-acceptance.html

力度分三档:QUICK(默认环境 + 问题清单)/ STANDARD(默认,含 A/B 演示与完整验收包)/ EXHAUSTIVE(全环境矩阵,仅显式要求时)。

适用场景 · When to use

• 发版前的系统性视觉走查
• 设计系统合规检查(design QA / 一致性审查)
• 回归性的 UI 审计——每个发现都可追溯到截图与代码坐标
• 需要「证据 + 用户拍板」而非 agent 自作主张改界面的场合