Brand Visual Quality

Brand Visual Quality

本 Skill 负责品牌视觉资产从母版到可验收交付物的生产质量闭环。它不替代设计系统、页面交互或普通文案审查。

触发条件

命中任一条件时使用：

• 新建或修改 logo、app icon、favicon、品牌图形、主题图标、单色版本或微尺寸变体。
• 需要证明多个格式、主题或尺寸来自同一母版，而不是各自手工漂移。
• 视觉复审发现描边、留白、重心、负空间、轮廓、像素贴合或单色退化问题。
• 需要形成视觉证据包、人工验收结论或 blocker 修复后的重跑记录。

以下场景不单独触发本 Skill：

• 仅调整 design token、组件主题、Figma-code adoption 或通用组件变体，交给 design-system-architecture。
• 仅审查页面任务路径、加载/空/错状态或普通交互，交给 UX / frontend Owner。
• 一次性改文案或不影响品牌资产谱系的普通颜色微调。

Owner 边界

BrandVisualQualityGate

所有品牌视觉 WorkUnit 必须依次执行以下子门禁；任一必需门禁缺证据时状态只能是 verification-pending 或 blocked。

MasterLineageGate

建立 MasterLineageMatrix：

不存在可追溯母版、多个变体无法反查同一谱系或手工覆盖未记录时，禁止标 accepted。

ThemeGeometryParityGate

形成 ThemeGeometryParity，逐主题比较 viewBox/画布、主体边界、留白、重心、轮廓与透明区。主题只允许颜色、明暗或明确批准的光学差异；未经记录的几何变化是 blocker。

MicroOpticalVariantGate

针对 favicon、16/20/24/32px 图标和其他微尺寸输出检查像素贴合、最细笔画、负空间、视觉重心与缩放后可辨识度。微尺寸可存在受控光学校正，但必须记录与母版的差异原因，不能伪装成等比缩放。

MonoMasterGate

形成独立单色母版或证明单色输出来自可复现变换。验证轮廓闭合、透明/实色语义、反白可用性和极端对比背景；彩色资产直接去饱和不自动等于合格单色母版。

VisualEvidencePackGate

生成 VisualEvidencePack，至少包含：

• 母版与派生资产身份、命令或工具版本。
• 同画布主题并排、微尺寸像素级预览、单色正反背景预览。
• 自动几何/文件检查结果与人工视觉结论；两者不能互相替代。
• 证据生成时间、reviewer、结论和未覆盖项。

文件存在、构建成功或单张截图都不足以证明视觉质量通过。

VisualBlockerResetGate

发现 blocker 后写 VisualBlockerResetRecord：记录 finding、受影响资产、补丁、旧证据失效范围、新母版身份和必须重跑的矩阵。修复单个输出后，至少重跑同母版全部主题、相关微尺寸、单色输出和证据包；不得复用 blocker 前的 accepted 结论。

ComponentTransparencyTopologyGate

复合透明标志（网络球、晶核、徽章、线框核心等）不得只凭整图画布四角透明或全局 opaqueRatio 通过。必须建立组件级透明拓扑：

负向假绿（必须阻断）：canvasCornersTransparent=true 且 globalOpaqueRatio<0.5，但 centerRoiOpaqueRatio≥0.99 且合同要求孔洞/线框透明 → topology-fail，WorkUnit 不得 accepted。分类器：classifyComponentTransparencyTopology（V97 / test-brand-visual-quality）。

产物契约

每个 WorkUnit 使用以下五类产物：

1. MasterLineageMatrix
2. ThemeGeometryParity
3. MicroMonoMatrix
4. VisualEvidencePack
5. VisualBlockerResetRecord（无 blocker 时写 N/A + no-blocker-observed）
6. ComponentTransparencyTopology（无复合透明资产时写 N/A + skipReason）

任务状态机：

textCopy code
draft → candidate → verification-pending → accepted
                                      ├──→ rejected
                                      └──→ blocked
blocked / rejected → 新 candidate（旧证据失效）

accepted 必须同时满足五类产物、自动检查和人工视觉结论；生命周期 gray/active 是 Skill portfolio 状态，与单个 WorkUnit 的 accepted 分离。

验证路线

生命周期与晋升

本 Skill 初始为 gray。结构化探针只证明契约可执行，不证明长期收益。

晋升 active 前必须满足以下任一取样门槛：

• 至少 3 个可比较品牌视觉 WorkUnit 的前瞻证据；或
• 至少 2 个独立项目的真实使用证据。

证据还必须说明误触发率、人工修正率、验证成本和 blocker 复发率均在可接受边界。若成本失控、与设计系统 Owner 重叠或持续产生假阳性，保持/回退 gray；无人消费时进入 sunset 评估。

正负样例

• 正向：同一 SVG 母版导出 light/dark、16~512px 与单色版本，五类产物齐全，自动 parity 通过且人工结论 accepted。
• 负向：只有导出文件和一张大尺寸截图，缺母版 digest、微尺寸/单色矩阵或人工结论，状态必须是 verification-pending。
• 阻断：dark 主题轮廓偏移；即使单文件已修，也必须先重跑同母版矩阵和证据包，完成 reset 后才能重新验收。