SuperAPI AI 工具集

craft-scoring

设计与创作

查看项目

更新于 10-26 09:39

技能介绍

Craft Scoring 是一套针对渲染产物的质量评分方法论技能,目的是把“更精致一点”这类模糊要求转成可逐项判定的检查与分数。它供 craft-qa 代理使用,核心原则是“机器先行、人眼后看”:能在脚本层面确定性判定的项目不消耗模型成本;A 组(确定性检查)只要有一项失败,就不进入 B 组(视觉评审)。

一、用途与顺序 该技能按两个阶段评审渲染成果。第一阶段是确定性机械检查,任一失败即立即驳回,不因总分高而抵消;第二阶段只针对机器无法判断的视觉品质,通过直接观察渲染结果进行 0–4 分评分。

二、A 组:确定性检查(脚本,硬失败门禁) 检查项包括:

  1. 画布规格:同一页包所有页面须为相同像素尺寸,声明纵横比误差不超过 0.5%。
  2. 画布约定一致性:prompt.md、tokens.json 中的画布声明须彼此一致,并与实际渲染一致。
  3. 版本新鲜度:prompt.md、tokens.json、meta.yaml 的 spec_version 三者须一致。
  4. 渲染新鲜度:渲染清单中的源哈希须等于当前 prompt.md 与 tokens.json 的哈希。
  5. 自相矛盾指令:同一对象同一属性不得存在相互冲突的取值。
  6. 禁止项自违反:"不得做"类约束与正文指令不得冲突。
  7. 字体加载:声明字体须 100% 实际加载,不得出现 tofu(方框)字符。
  8. 文本截断:不得出现 clipping 或 overflow。
  9. 对比度:按后文“对比度与原文忠实度”中的角色标准判定。
  10. 图表数据:数值、单位、顺序须与原始数据 100% 一致,柱状图 y 轴须从 0 开始。
  11. 页面 ID 一致性:pages/ 下文件名、顺序、kind 须与 meta.yaml、catalog.json 一致。

三、对比度与原文忠实度:按角色区分 这里存在规则冲突:设计惯例允许以可访问性为由偏离原始设计,而实际参考案例常将低对比作为设计手法(如非激活目录项、装饰性水印)。该技能的判定方式是按文本角色区分:

  • 承担语义传递的文本(正文、数据标签、坐标轴、表格数值、CTA、唯一信息来源):须达到 4.5:1,大文本 3:1,否则硬失败。
  • 有意弱化的元素(非激活目录项、装饰背景水印、同一信息在别处完整存在的重复元素):不设对比度下限,但必须在 transform_contract 中声明。 声明的字段包括 element_id、action(preserve)、role(decorative-deemphasis)、contrast(measured 实测值、below_aa 标记)、justification(说明低对比本身承载的语义)与 accessibility_note。未声明的低于 4.5:1 文本按硬失败处理;已声明的,只核查其角色是否确实为弱化(防止把正文伪装成弱化元素)。

四、B 组:视觉评审(0–4 分 × 6 项,共 24 分) 仅评机器无法判断的项目:

  • C1 网格吸附:主要元素边缘是否贴合声明网格(4 分:95% 以上在 2px 内;0 分:并排卡片高度不一)。
  • C2 光学对齐:是否按视觉中心而非数学中心对齐。
  • C3 韩文换行:不得在词或语节中间断行,不得出现孤行;该技能指出这是韩文页包的最大薄弱点,英文换行逻辑会忽略韩文语节,建议以 word-break: keep-all 和按语节检查为默认。
  • C4 留白节奏:重复的 gap、padding 须为令牌倍数,变异系数不超过 10%。
  • C5 密度均衡:语义元素占比须与声明的 space 轴(airy 30–65%、balanced 50–80%、dense 70–90%)匹配。
  • C6 数据墨水比:图表中(语义标记 + 直接标签)/ 全部元素不低于 0.70,网格线不超过 3 条。

五、合格条件 A 组硬失败为 0,且 B 组总分不低于 19/24,且所有单项不低于 2 分。

六、检查输入 不得只看 PNG。Web 轨道应在渲染时导出 DOM computed style,实测对比度、字体与留白;PPT 轨道在生成原生 .pptx 时从 XML 实测形状坐标与字体列表,并确认幻灯片外对象为 0。两者都不可行时,须注明 structural_check: unavailable,并将部分 A 组项目标为 unverified,不得提升为 pass。

七、产出 输出到 _workspace/{batch}/craft_qa/{slug}.json,包含 slug、hard_fails、checks_A 各检查状态、scores_B 六项分数、total_B、verdict、structural_check 与 repair_requests。

八、明确禁止 不得用眼睛替代 A 组机器测量;不得给出“整体干净”之类笼统评语,须写项目分与失败坐标;不得以时间或配额不足作为通过理由,needs_review 才是诚实的结论。