Impeccable Finish Reviewer 终审机制解析AI 设计构建物的七重检查、四词裁决与 comp-diff 证据链【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccableImpeccable 是一套面向 AI 设计构建build的设计语言与工作流。本文聚焦其中最后一个闸门——Finish Reviewer终审评审它负责在构建完成后、交付用户之前以全新视角对成品做一次与构建线程完全隔离的终审并输出四词裁决recapture/rebuild/fix/ship。读完本文你将掌握终审的输入契约、按序执行的七项检查Evidence、Persistence、Fidelity、Ceiling、Contract、Truth、Floor、元素矩阵TYPE / MATERIAL / GROUND的判定方法以及裁决后的评分回执Verdict Pass如何闭环。本文以仓库中的 degraded/finish-reviewer.md 为骨架其权威版本位于 skill/agents/impeccable-finish-reviewer.md并对照 crates/comp-verbs/src/comp_diff.rs、docs/COMP-FIDELITY.md、skill/reference/craft-floor.md 与 skill/reference/new-work.md 做源码级印证。一、角色定位闸门而非同事Finish Reviewer 是 Impeccable 构建流程中最后一道闸门。它的核心设定在文档开头就写得很清楚全新视角fresh eyes评审站在构建线程的注意力引力之外对已完成的成品做终审只读不写评审不编辑任何东西修复由父代理parent应用无浏览器绝不渲染、截屏、启动服务器或打开页面只依据传入的文件评审硬性回合上限hard turn ceiling运行到上限会被无预警终止如果运行结束前没有写完约定的章节五个或单独一个 recapture 章节则视为返回空结果阅读是一种配额allowance只读传入的输入外加 craft floor绝不读其他技能参考文件优先读取截图、comp、卡片与契约对构建的主文件做抽样而非遍历整棵树大约在第 10 回合停止阅读、开始写作。任何未读内容必须在章节上方的行里点名说明。在无子代理subagent能力的 harness 中该角色以行内方式运行此时文档要求完全脱离刚完成的工作、只采纳本文件指令完成这一轮并在回报时用一行披露这一替代degraded 模式。这也是 .rovodev/skills/impeccable/reference/degraded/finish-reviewer.md 存在的意义由构建期工具从 skill/agents/impeccable-finish-reviewer.md 生成供无子代理 harness 直接加载。二、输入契约评审拿到什么就只依据什么评审的输入包packet是固定的文档要求除非传入的截图路径存在且被 brief 点名否则一律去.impeccable/review/目录查找绝不臆造文件名。标准输入包括输入说明原始请求最初的用户请求已确认的用户回答构建过程中确认过的答案产物路径构建出的 artifact 路径截图存于.impeccable/review/web 为desktop.png、mobile.pngnative 按设备类别命名如phone.png、tablet.pngadaptive 按 OS 加后缀方向契约THESIS、OWN-WORLD、STORY、FIRST VIEWPORT、FORM 六个块PRODUCT.md 路径产品真相的持有者hook / detector 既有发现已有的机械检查发现QUALITY BAR 卡片路径所选世界的质量条卡片经批准的 comp 路径comp-led 构建必需code-led 构建没有改用所选决策 comp 作为critique-reference单独标注构建状态comp-led 构建还需.impeccable/build/state.json、.impeccable/build/spec.json以及两个 diff 目录.impeccable/review/diff/hero/与.impeccable/review/diff/final/每个目录含side-by-side.png、heatmap.png、regions/id.png成对裁剪、report.json区域评分与裁决craft floor 路径reference/craft-floor.md即仓库中的 skill/reference/craft-floor.md平台参考nativeios/android/adaptive构建额外携带 skill/reference/ios.md 或 skill/reference/android.md并附带一行没有运行 detector的说明当 harness 能看图时文档要求先开截图、comp 与卡片并用自己的话盘点 comp 的显著元素然后才读方向契约或任何构建者撰写的摘要——因为锚定在契约上的评审会继承构建者抽象掉的东西。这是一条重要的方法学原则评审的锚点是被批准的 comp 本身而不是契约对它的转述。三、七项检查按序执行的证据链评审按固定顺序执行七项检查编号 0 到 6。前一项失败会改变整个评审的形态而不是叠加一份评分。Check 0 —— Evidence证据有效性在一切检查之前先验证必需截图存在且每张都有效。必需集平台完整视口集web 为desktop.png与mobile.pngnative 为每个发布设备类别一张加上调用 brief 点名必需的每一张截图以及上报的用户视口user-width.png。有效定义无黑色或空白区域内容与文件名声明一致一张声称是 Visit 部分的截图却显示 About 部分即无效声称整页的地方能看到文档顶部尺寸与命名的视口相符。缺失即失败必需截图缺失与损坏同样失败——没人截的视口就是没人检查过的视口它不能发布。任何一张截图失败整个评审改变形态第一行返回disposition: recapture然后只写一个recapture章节列出每个缺失或无效文件及其有效截图应展示的内容然后停止。绝不在损坏的证据上构建矩阵——基于坏截图的裁决会把损坏洗白成批准父代理欠你一次基于有效截图的完整复审而不是一轮打分。Check 1 —— Persistence持久化与流程完整性检查构建流程的产物是否完整落盘PRODUCT.md 必须存在comp-led 构建必须有.impeccable/build/state.json且comps或skipped当 surface 轮已锁定 comp 时、spec、plates、hero各阶段都处于closedcomp-led 配置没有 state 文件或 state 的comps阶段从未关闭意味着 comp 轮被跳过、构建仅凭世界描述进行——这是压过 craft 的材料级发现material finding带forced记录的阶段关闭必须作为材料级发现披露除非用户以 packet 引用的原话降级了 comp 的权威hero.gate.score低于 0.72 或缺失 state 文件意味着复现未经验证是材料级发现且无论如何.impeccable/review/hero-repro.png必须存在DESIGN.md 早于本次构建扩展或改版时它必须匹配所构建的世界全新世界时 DESIGN.md 由 documenter 在评审之后撰写因此此处缺失不是发现.impeccable/mocks/下存在 comp 轮 comps 时必须有批准记录命名批准 comp 的 surface brief或 sidecar 中的approved标志无记录的选择意味着批准点被跳过是材料级发现。.impeccable/mocks/decision/下的文件是方向轮的发牌手牌在任一 comp 轮之前产生不隐含任何批准。Check 2 —— Fidelity保真度先测量再判断测量不到的东西这是全文最重的检查方法论是从测量开始然后判断数字测不到的东西先读测量先读.impeccable/review/diff/final/report.json以及 hero 目录每个被评missing或contradicted的区域只要regions/下的成对裁剪不能证明评分有误就按该状态进入矩阵且必须说明原因评match的区域仍要亲自审视字型性格lettering character与材质material——数字不测这两样。对照自己的元素盘点用自己对被批准 comp 的元素盘点来对照绝不使用契约对它的转述。核对拓扑topology、阅读顺序reading order、焦点比例focal scale、重叠与 z 序、密度density、特征几何signature geometry、主操作的呈现CTA 在 comp 上是实体做功、溶解或盖章的元素其纯矩形渲染即属 contradicted、导航项与图标、标题层级与比例关系。分类每个显著元素match/acceptable adaptation/missing/contradicted/added without approval。矩阵强制三行缺一不可TYPE字型显示字型的性格、压缩度、宽度、字重、对比、字脚终端与 comp 对照性格不同的字体无论布局多忠实都是 contradictedMATERIAL材质comp 显示为手绘、纹理、立体或摄影材质而元素被渲染成扁平 CSS 或干净矢量无论位置如何都属 contradicted——媒介是承诺的一部分GROUND页面底色页面场域的值与色温对照 comp工具允许时从两侧像素采样而非凭记忆判断有纹理或平铺覆盖基底色时以屏幕上的净结果为读值。底色比 comp 暖或冷都是 contradicted尤其要追查向渲染先例漂移的倾向浅底漂向暖奶油色、深底漂向蓝黑石板色。无 comp 时的降级规则没有被批准 comp 时TYPE 与 MATERIAL 不失效——对照契约的 OWN-WORLD 与世界的真实材质判断并把伪造的物理性CSS 斜面、浮雕、仿冲压金属或粉笔效果视为当面 contradicted模仿材质是机器设计最可靠的标志。GROUND 收窄但不失效OWN-WORLD 点名了颜色则以它为靶同样适用暖/冷判断OWN-WORLD 没点名颜色则无 GROUND 权威评审如实说明而不是自造一个靶子——评审者发明的目标会把这项检查变成口味问题。改编adaptation只有引用证据才算有意只有当它引用迫使其发生的用户回答、surface brief、无障碍需求或产品真相时改编才是有意的无引用的偏离就是缺陷。缺失特征元素、拓扑改变或未经批准新增内容直接使 fidelity 失败且压过 material_fixes 中的一切 craft 点。重建指令rebuild directive条件当 MATERIAL 在焦点元素上被否定或矛盾是整页而非例外时停止逐条修补——第一条材质修复必须是重建指令点名需要重新推导的 comp 区域与需要产出的资产。对一张被否定的页面打补丁清单等于把否定洗白成批准。要求产出资产的修复必须明说produce: as a raster asset绝不能用父代理会用 CSS 回应的样式调整来表述。最后一条边界comp 是构图、拓扑、元素清单、密度、字型性格与材质的规格但不是语义、无障碍或响应式重排的像素规格该许可覆盖翻译translation绝不覆盖替换replacement。Check 3 —— Ceiling天花板对照 QUALITY BAR 卡片对质量条卡片点名世界自带的、构建未用的原生设备以及框架、深度、字型处理、装饰密度、动感。卡片治理承诺与完成度绝不治理构图。Check 4 —— Contract逐条承诺验证首先验证 FORM 携带概念掷骰concept roll打印的 seed key无 seed key 或父代理无法佐证的契约意味着掷骰被跳过是任何 craft 点之前的材料级修复。然后对五个块逐一提问渲染是否兑现了承诺对第一视口应用记忆测试memory test如果读者只看一个视口就走了一小时后他会描述出什么如果诚实答案是一种氛围概念还没有承诺到位。Check 5 —— Truth真相演示数据必须创作并标注为合成synthetic不得有编造的商业声明未回答的声明必须以标记的占位符呈现而不是省略spec 中每个栅格区域都必须以其 plate 发布spec 点名文件、页面引用它、该区域的 diff 行不是missing不得用渐变、内联 SVG 或许多顶点的clip-path顶替每个产出的资产必须肉眼可见地出现在截图中以近零透明度应用或埋在 wash 后面的资产只是合规凭证compliance token而非已发布的材质。packet 中 detector 的buried-raster与organic-clip-path发现都是材料级修复——这两条规则在 docs/COMP-FIDELITY.md 中有专门定义clip-path: polygon()超过 10 个非网格顶点、或path()含 3 条以上曲线段即命中organic-clip-pathurl()层被全不透明渐变 wash 覆盖、或栅格背景/img透明度低于 0.15 即命中buried-raster。Check 6 —— Floor工艺底线读取 craft floor 的 Refuse 清单并对照截图kicker/eyebrow、非新粗野主义世界中的硬偏移阴影、字形图标glyph icons、系统显示字体、渐变文字、侧边条纹等。被禁元素即使与 comp 无关也是材料级修复——构建者写它之前已加载同一条禁令对 comp 的保真不能授权 floor 拒绝的东西。父代理的 hook 发现覆盖机械部分此检查存在的原因是没有 hook 的 harness 到达评审这里时没有机械发现而最近两次 live session 曾带着五个 kicker 越过了一个从不看的评审。文档还明确不要跑第二遍 detector机械发现属于父代理的 hooks。四、四词裁决disposition 的推导规则返回值的第一行必须是四个词之一且推导而来绝非感受词触发条件recapture证据检查Check 0失败rebuild重建指令条件触发MATERIAL 全面被否定等fixmaterial_fixes 非空ship仅当矩阵中没有 contradicted 或 missing 行校准对象是被批准的 comp 与世界质量条而不是构建中可见的努力设计总监会退回的页面无论多能运行最多是 fix焦点工艺远低于 comp 的页面无论结构多完整都是 rebuild。父代理逐字上报 disposition 词且无权软化它。五、输出契约disposition 行 五个章节先输出 disposition 行然后恰好五个章节persistence通过/失败附具体细节fidelity元素矩阵——每个显著元素给出 match、adaptation、missing、contradicted 或 added without approval改编必须引用其证据或整体标faithfulceiling未用的原生设备或reachedmaterial_fixes有序排列最实质的在前保真失败排在 craft 之前每行一行、关联到某个检查或契约承诺最多八条keep一行点名修复时绝不能被稀释的东西。recapture 返回则用单一recapture章节替换上述五个章节。缺失输入在章节上方一行点名。不要赞美不要总结性散文。六、Verdict Pass修复后的评分轮父代理带着修复后的截图回来时评审进入评分模式而非重新搜猎。三个条件会将你带出评分模式重截的截图未通过 Check 0——照评审轮原样返回disposition: recapture重建指令后的返回——这是新一轮完整评审因为重建整体替换区域只给指令打分会把重建漏掉的东西发布出去packet 携带与先前裁决矛盾的用户提供的截图——这是新一轮完整评审且以用户截图为第一证据用户对真实页面的截图胜过父代理摆拍的一切截图。评分规则同样严苛父代理在同一批截图文件上重截因此必须重读那些确切路径臆造的带轮次戳文件名指向虚空父代理对修复的口头叙述不是证据声称修复而在重截中看不到的就是未解决对评审轮每条材质修复给一行resolved / partial / unresolved并与新截图中肉眼可见的内容绑定机制性地回应修复、位置动了但发现点名的质量依旧缺席至多算 partial然后点名至多三条修复批次自身引入的回归按同一矩阵规则判定其他什么都不说不开新猎、不开新检查返回恰好两个章节verdict评分清单与remaining仍开放项或clear最后以对剩余开放项重新计算的四词 disposition 行收尾。两个硬约束未解决或部分解决的材质发现永远不能重算为 ship此处赢得的 ship 只覆盖被评分的修复、不覆盖整张表面且必须照此明说。七、与构建流程的衔接从 spawn 到闭环终审不是孤立角色。构建流程在 skill/reference/new-work.md 中规定了它的调用方式构建线程完成两轮检查后不再自己抛光其余工作交给终审web 侧先跑一次impeccable detect --json处理机械问题其余发现交给评审评审必须新鲜 spawn不继承对话历史fork_turns: 0——继承你 transcript 的评审会继承你的框架、乐观与抽象一切它需要的信息都在输入包中只有完全没有子代理能力的 harness 才允许退化为行内执行从 degraded 文件运行且必须披露按 disposition 行动recapture重截后完整复审rebuild跳过修复批次直接重建区域内整块替换因此回到完整评审而非评分轮fix一批应用全部修复、重建一次、重截同视口送回评分ship按实际范围汇报并交给 documenter预算无人值守运行两轮封顶第二轮仍开放时把表格摆到用户面前选择原样发布或再投一轮用户证据重开评审当用户以证据自己的截图、与 comp 具名的偏差回应 ship 时该证据胜过一切摆拍截图——把用户材料放进 packetspawn 全新评审做完整复审行内打补丁并自我认证是被拒绝的页面发布两次的方式。recapture/fix/rebuild/ship的四词体系贯穿 new-work.md 第 7 节的全部分支可见终审是构建流程的正式组成部分而非可选的 QA 建议。八、证据链的底层comp-diff 如何打分终审 fidelity 检查的测量来自impeccable comp-diff。文档指出每个 diff 目录的report.json含 per-region 分数与裁决其实现位于 crates/comp-verbs/src/comp_diff.rs可印证以下事实对齐align_build默认top对齐缩放构建到 comp 宽度、取首视口行另有stretch、cover随后best_shift在 256px 工作宽度上做小范围平移搜索最大 ±4% 宽用模糊灰度的 SSIM 找最佳位移——comp-diff 的--align参数即此处的align四个维度structureSSIM、color量化直方图交集 Lab 主导调色板匹配见m::color_score、detail高频能量比m::detail_score(a, b, 12, 8)、bands水平分段边界一致性m::horizontal_bandsm::band_score分 kind 加权weights函数plate/image为 (0.25, 0.2, 0.5, 0.05)——材质类区域主要按 detail 判texture为 (0.15, 0.35, 0.5, 0.0)text为 (0.5, 0.25, 0.15, 0.1)——文本区域主要按 structure 判control为 (0.45, 0.35, 0.2, 0.0)默认 (0.35, 0.25, 0.25, 0.15)裁决阈值verdict_fordetail_raw 0.15 →missingpainted 类且 detail 0.5 →missingstructure 0.3 →contradictedoverall ≥ 0.8 →matchoverall ≥ 0.6 →drift其余contradicted。这与终审文档中match / drift / missing / contradicted的评审词汇完全一致——测量层直接生产评审词汇区域来源resolve_regions优先读 spec 的regions含box与kind无 spec 时自动从 comp 的水平分段strength 0.2切 band 区域最少退回 top/bottom 两段产物write_artifacts写side-by-side.pngCOMP 与 BUILD 并排 OVERALL/STRUCT/COLOR/DETAIL/BANDS 分数条、heatmap.png差异以红色标注匹配为绿色、漂移为黄色见heat_label、regions/id.png成对裁剪带各自 verdict 与分数以及report.json阈值退出--threshold低于阈值时退出码 3 并提示the reproduction is not done。docs/COMP-FIDELITY.md 进一步记录了该测量体系的门槛hero gate 要求 comp-diff 至少 0.72 且无missing区域、至多三分之一contradictedplates gate 要求每个 plate 至少 1.5 倍区域像素宽、对 comp 裁剪cover 对齐、分 kind 加权最低 0.5这两处阈值在build-phase.mjs顶部为常量文档明确说明会随证据移动。该文档还如实记录了校准数据comp 对自身 100%、平移 12px 后 87%、擦除插画后 plate 区域missing30% 等以及多轮评估中分阶段构建在真正运行时保真度比一次性书写构建高 10–15 个百分点的观察——这些都属于项目自身的验证记录而非外部营销结论。九、craft floor终审的第六条腿终审 Check 6 的执行依据是 skill/reference/craft-floor.md。该文件分两个清单Verify对构建结果的检查而非意图正文与占位文本对比度 ≥ 4.5:1、大字 ≥ 3:1彩色表面上从该色相或前景色调次级文字绝不用灰阴影带偏移与柔和模糊零偏移的彩色光晕是装饰间距紧凑分组、组间慷慨分离、标题上方空间大于下方正文字宽 65–75ch、显示最大 6rem、tracking 下限 -0.04em动效只做一个编排时刻而非散落效果、从可见默认态做指数级 ease-out状态覆盖 hover/disabled/loading/error/empty浏览器表面文本选区、光标、自定义滚动条、焦点环、下划线偏移、表格数字都要从调色板主题化文案是产品自己的语言每个 brief 需求存在且数秒内可找到。Refuse类别默认值brief 自己的话可以挣回任何一条同尺寸图标标题文本卡片阵列、hero-metric 模板大数字小标签辅助统计、标题上方加 kicker/eyebrow这是禁令不是默认任何 brief 都挣不回来、无关信息量的节编号、不需要的模态框、渐变文字、为装饰而玻璃与模糊、超过 1px 的彩色border-left/right、非新粗野主义世界中的硬偏移阴影、占位的 sparkline/进度环、为技术感穿等宽字体戏服、own-world 页面用系统显示字体、用 Unicode 字形/emoji 顶替图标系统、用几何蒙版顶替有机轮廓、按类别而非使用场景选浅/深色。另有 codex 专属条款tracking 不超 -0.04em、一次声明一种抬升方式、真实插画或没有、背景只在有实际画布/地图/蓝图时才用条纹与网格、声明与配置来自供给的真相与 gemini 专属条款永不悬停动画图片。终审把这张清单逐条对着截图执行——这是无 hook harness 的最后一道防劣质slop闸门。结语用证据链替代说服Impeccable Finish Reviewer 的核心设计哲学可以用文档中的一句话概括校准对象是 comp 与质量条绝不校准构建中可见的努力。它通过可验证的截图证据Check 0、落盘的流程状态Check 1、先测量后判断的保真度Check 2、质量条天花板Check 3、逐块兑现的契约Check 4、真相审计Check 5与工艺底线Check 6最终收敛到一个推导出来的四词裁决。整个过程几乎没有留白给说服坏证据直接recapture全面被否定直接rebuild有修复清单就fix只有矩阵全绿才ship而 Verdict Pass 进一步保证修复后的评分只基于肉眼可见的重截证据绝不放行未解决的发现。这套机制连同 crates/comp-verbs/src/comp_diff.rs 的量化测量与 docs/COMP-FIDELITY.md 的门槛记录共同构成了 AI 视觉构建在交付用户前的最后一道、也是最具约束力的一道闸门。【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考