Impeccable Finish Reviewer读懂 Impeccable 终审机制——从证据校验、保真度矩阵到四词裁决的设计交付门禁【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccableImpeccable项目自述为The design language that makes your AI harness better at design为每次视觉构建流程配置了一位独立的「终审评审者」Finish Reviewer它不写一行代码只对已经完成的产物做最后一道交付审查并返回一个不可被弱化的裁决词。本文以仓库中的 degraded/finish-reviewer.md 为骨架结合其正式 Agent 定义plugin/agents/impeccable-finish-reviewer.md、skill/agents/impeccable-finish-reviewer.md、构建门禁实现build_phase.rs、差异对比工具comp_diff.rs与工艺底线文档craft-floor.md完整还原这套「终审检查 → 裁决 → 输出契约 → 修复评分」机制的每一个细节。读完你将掌握评审者需要哪些输入、七项检查如何逐条执行、四种裁决词如何推导、修复轮次如何评分以及这套机制如何在源码层面落地。一、评审者定位构建线程之外的「新鲜眼睛」Finish Reviewer 的核心设计前提是构建线程自带注意力引力——写代码的 Agent 会不自觉地相信自己造的页面是成功的。因此终审者必须站在构建线程之外以全新视角审视一个「已经完成」的产物。只审不改终审者不编辑任何文件所有修复由父 Agent构建者执行。无浏览器评审者「没有浏览器」绝不渲染、截图、起服务器或打开页面只基于传入的文件进行审查。内联替代机制当宿主不具备子 Agent 能力时即degraded退化模式对应文档存放在reference/degraded/目录评审以内联方式在当前上下文运行——此时需要彻底脱离刚完成的工作、仅采用本文文件的指令并在汇报时用一行披露「该评审是替代执行的」。正式模式下则要求「全新 spawn、零会话历史继承」new-work.md 的## 7. Inspect and finish一节明确fork_turns: 0因为a reviewer that inherits your transcript inherits your framing。硬轮次上限运行存在硬性轮次上限超限即终止。根据正式 Agent 定义maxTurns: 30、effort: high、model: inherit可用工具限定为Read, Bash, Glob, Grep见 plugin/agents/impeccable-finish-reviewer.md 的 frontmatter。在约第 10 轮之后停止阅读、开始写作任何未读到的输入都要在章节上方一行注明。二、输入契约Input Contract评审者凭证据说话终审者只依据打包传入的证据运行完整的输入清单如下输入说明原始请求original request用户最初提出的构建诉求已确认的用户回答方向轮/提问轮中用户确认过的答案产物路径待评审的 artifact 路径截图证据父 Agent 捕获、存放于.impeccable/review/的截图Web 端为desktop.png与mobile.png原生端为设备类别名如phone.png、tablet.png自适应平台按 OS 加后缀方向契约THESIS、OWN-WORLD、STORY、FIRST VIEWPORT、FORM 六个块见 new-work.md 的## 5. Record the decisionPRODUCT.md 路径产品真值的归属文件已有 hook/检测器发现机械性发现归父 Agent 的 hooks 负责QUALITY BAR 卡片路径所选世界的质量基准卡已批准 compcomp-led 构建code-led 构建没有此时传入的是「决策 comp」作为独立的批评参考输入须明确标注身份构建状态与规格comp-led.impeccable/build/state.json、.impeccable/build/spec.json差异目录comp-led.impeccable/review/diff/hero/与.impeccable/review/diff/final/各含side-by-side.png、heatmap.png、regions/id.png成对裁剪与report.json来自impeccable comp-diff的逐区域得分与裁决craft-floor 路径技能包的reference/craft-floor.md工艺底线平台参考原生构建reference/ios.md/reference/android.md并附一行「未运行检测器」的声明两个关键规则截图路径以调用简报点名为准文件存在即权威简报未点名或路径缺失时才去.impeccable/review/查找绝不自造文件名能看图时先看图——先打开截图、comp、卡片用自己语言盘点 comp 的显著元素再读方向契约或构建者摘要因为「锚定在契约上的评审会继承构建者抽象时丢失的东西」。三、Check 0 · 证据校验Evidence坏证据上不建矩阵第一项检查优先于一切验证必需截图存在且每张有效。必需集合平台完整视口集Webdesktop.pngmobile.png原生每个出货设备类一张、调用简报点名的每张图、以及上报的用户视口user-width.png。有效性判定无黑色或空白区域内容与文件名声称一致一次访问页显示 About 区块是无效的声称整页的地方文档顶部可见尺寸与命名视口相符。缺失 畸形必需截图缺失与畸形同罪——没被任何人截图的视口就是没被任何人检查的视口不能出货。任一截图失败整个评审改变形态首行返回disposition: recapture随后只有一个recapture章节逐条列出缺失/无效文件及有效截图应显示的内容然后停止。原文档的措辞掷地有声由破损截图推导出的裁决等于把破损洗白成批准绝不在畸形证据上建矩阵。四、Check 1 · 持久化审计Persistence构建状态必须闭合第二项检查核对产物之外的「流程证据链」PRODUCT.md必须存在。comp-led 构建必须存在.impeccable/build/state.json且compssurface 轮锁定时为skipped、spec、plates、hero各阶段均为closed。无 state 文件、或comps阶段从未闭合 → comp 轮被跳过、构建仅凭世界描述运行是压过工艺问题的实质性发现。带forced记录的阶段闭合必须披露为实质性发现除非用户在打包引述的原文中降级了 comp。hero.gate.score低于0.72或 state 缺失 → 复现未经证明是实质性发现且无论何种情况.impeccable/review/hero-repro.png都必须存在。批准记录.impeccable/mocks/下存在 comp-round comps 时必须同时存在批准记录点名批准 comp 的 surface brief或其 sidecar 中的approved标记无记录的 comp 即批准点被跳过。.impeccable/mocks/decision/下的文件豁免——那是方向轮的「发牌手」在任何构建路径下都不隐含批准code-led 构建根本没有 comp 轮。这里可以印证源码0.72 正是 hero 门禁的实现常量crates/comp-verbs/src/build_phase.rs第 29 行const HERO_MIN: f64 0.72;门禁以 72% 整体匹配率且无硬否决项缺失区域、被反驳的 plate 或文本块、SVG 插图、被裁剪的 plate、任意分数下的虚构墨块作为通过线详见 new-work.md 的 hero gate 一节。五、Check 2 · 保真度矩阵Fidelity从测量出发再判断测量无法覆盖之物保真度检查遵循「先测量、后判断」的顺序先读测量先读.impeccable/review/diff/final/report.json以及 hero 版本。每个被评missing或contradicted的区域都构成该状态的矩阵行除非regions/下的成对裁剪证明该得分有误并说明理由即便评match的区域评审者的眼睛仍要检查数字测不到的字形性格与材质。对照自己的元素清单基于自己对已批准 comp 的元素盘点而非契约对 comp 的摘要检查拓扑、阅读顺序、焦点比例、重叠与 z-order、密度、特征几何、主行动的处理方式在 comp 中物理生效、溶解或盖章的 CTA 是特征元素其平直矩形版本即被反驳、导航项与图标、标题层级与比例关系。五级分类每个显著元素归类为match匹配、acceptable adaptation可接受改编、missing缺失、contradicted反驳、added without approval未经批准新增。矩阵中强制存在三行行判定要点TYPE展示字体的性格、压缩度、宽度、字重、对比度、字脚对照 comp无论布局多吻合性格不同的字体即被反驳MATERIALcomp 呈现手绘、纹理、立体或摄影材质而实现用平直 CSS 或干净矢量 → 反驳与位置无关媒介本身是承诺的一部分GROUND页面底色的明度与色温对照 comp工具允许时从两侧采样像素而非凭记忆判断纹理/贴图覆盖底色时读净屏结果比 comp 暖或冷的地面即被反驳重点排查向「渲染先验」漂移浅底暖奶油、深底蓝黑板岩无已批准 comp 时TYPE 与 MATERIAL 不放松——改对照契约的 OWN-WORLD 与世界的真实材质假物理性CSS 斜角、浮雕、仿冲压金属或粉笔特效当场判反驳仿制材质是机器设计最可靠的标志。GROUND 收窄而非放松OWN-WORLD 点名颜色则以此为目标做冷暖判定未点名则无 GROUND 权威评审如实说明而非给出裁决评审自造目标会把检查变成品味。critique-reference comp 只是「挑衅而非规格」无元素矩阵、无改编引证、无资产义务唯一贡献是图里敢做而构建没敢做的值得吸收的胆量按普通有序修复进入material_fixes。改编规则改编仅在引用「用户回答、surface brief、可访问性需求、产品真相」中的被迫因素时才视为有意未引证的偏离即缺陷。缺失特征元素、拓扑改变、未经批准新增内容 → 保真度失败压过material_fixes中一切工艺点。重建指令触发条件焦点元素的 MATERIAL 被反驳、或反驳是整页而非例外时停止下达修补——第一条修复必须是重建指令点名需重新推导的 comp 区域与需产出的资产对一张被拒的页面的补丁清单等于把拒绝洗白成批准。需要产出资产的修复必须显式写明如 produce: as a raster asset绝不能用样式调整表述让父 Agent 拿 CSS 应付。comp 的权限边界comp 是构图、拓扑、元素清单、密度、字形性格、材质的规格不是语义、可访问性、响应式重排的像素规格——这层豁免只覆盖翻译绝不覆盖替换。六、Check 3 · 质量天花板Ceiling对照 QUALITY BAR 卡片第三项检查把构建与所选世界的 QUALITY BAR 卡片对照点名世界原生设备中未被使用的、框架、深度、字体处理、装饰密度、动效。注意权限划分卡片管辖承诺与完成度commitment and finish绝不管辖构图。七、Check 4 · 契约逐条承诺Contract, promise by promise第四项检查先验证 FORM 携带概念掷骰concept roll打印的 seed key——无 seed key 或父 Agent 无法佐证的契约意味着掷骰被跳过这是先于任何工艺点的实质性修复。然后对五个块逐一质问渲染是否守住了承诺并对第一视口应用记忆测试若有人看一个视口就离开一小时后他还能描述什么——见 new-work.md 的 The first viewport is a thesis。八、Check 5 · 真实性Truth演示数据与资产合规演示数据必须创作并标注为 synthetic合成。不得发明商业性声明未回答的声明以标注的占位符呈现而非省略。规格中的每个光栅区域必须以其 plate图版出货规格点名文件、页面引用它、该区域的 diff 行不是missing——不允许用渐变、内联 SVG、或高顶点数clip-path顶替。每个产出的资产必须肉眼可见于截图中以近零透明度应用或被 wash 层埋住的资产只是「合规代币」而非出货材质。检测器包中的buried-raster与organic-clip-path发现即为材质修复项。这两条检测器发现都可以在源码中定位crates/core/src/checks/css_scan.rs中定义了organic-clip-path第 946、977 行与buried-raster第 1186 行规则正是 new-work.md 中 Gradients, glass, generic icon tiles, and many-vertex clip-path polygons where an authored asset belongs are the gap wearing chrome; the detector flags the last two 所说的机械化防线。九、Check 6 · 工艺底线Floor对照 Refuse 清单最后一项检查读取 craft-floor.md 的 Refuse 清单把截图逐一对照kicker/eyebrow标题上方的小标签、新粗野主义世界之外的硬偏移阴影box-shadow: 4px 4px 0、字形图标Unicode 字符/emoji 顶替图标系统、系统展示字体Impact、Arial Black 等、渐变文字、侧条纹卡片/列表项/引用块上超过 1px 的彩色border-left/border-right等。关键规则被禁元素即使是材质修复项——即使 comp 中也没有它——构建者在写它之前加载过同一条禁令对 comp 的忠实不能授权底线所拒绝的东西。父 Agent 的 hook 在运行时已机械覆盖此项该检查存在的意义是无 hook 的宿主到达终审者时没有任何机械发现而最近两次 live 会话在从未检查的评审者面前漏掉了五个 kicker。注意边界不做第二次检测器扫描——机械发现归父 Agent 的 hooks。十、裁决词汇表Disposition四个词无更多返回首行必须是且只能是四个词之一词推导条件disposition: recapture证据检查失败disposition: rebuild重建指令条件触发保真度整体失败而非补丁可救disposition: fixmaterial_fixes非空disposition: ship矩阵中无 contradicted 或 missing 行规则重申词是推导出来的不是感觉出来的校准对象是已批准 comp 与世界质量条绝不是构建中可见的努力程度——设计总监会退稿的页面至多是 fix哪怕它功能完备焦点工艺远低于 comp 的页面是 rebuild哪怕结构完整。父 Agent 逐字转达裁决词且无权软化它。评审者是用户前的最后一道门不是给同事报喜的同事。十一、输出契约Output Contract首行 恰好五节先返回裁决行然后恰好五个章节persistence—— pass/fail 并给出具体细节fidelity—— 元素矩阵每个显著元素为 match / adaptation / missing / contradicted / added without approval改编须引证证据或写 faithfulceiling—— 未使用的原生设备或 reachedmaterial_fixes—— 有序列表最材质性的在前保真度失败先于工艺点每条一行并挂钩到具体检查或契约承诺至多八条keep—— 一行点名修复时绝不可被稀释之物recapture 返回用单个recapture章节来自 Check 0替换这五节。缺失输入在章节上方一行点名。无赞美、无总结性散文。差异证据的生成端在源码中清晰可见crates/comp-verbs/src/comp_diff.rs负责渲染side-by-side.png第 550 行附近与heatmap.png第 486、552-553 行并将report.json与各路径写入输出目录crates/comp-verbs/src/build_phase.rs在 hero 门禁与最终评审差异两处写入report.json第 1012、1431、1575 行。这些正是终审者 fidelity 检查读取的「测量」证据。十二、修复后评分轮Verdict Pass不再是重猎而是打分父 Agent 带修复后的重截图返回时评审者进入评分模式而非重猎模式。三种情形强制退出评分模式重截图未过 Check 0→ 与评审轮完全一致地返回disposition: recapture。对重建指令的返回→ 全新完整评审重建整体替换区域只评指令会让重建漏掉的一切出货。携带用户自供截图的包→ 全新完整评审以用户截图为首要证据用户对真实页面的截图胜过父 Agent 摆拍的每一张。评分轮规则父 Agent 在同一批截图文件上重截图必须重读完全相同路径自造轮次戳文件名指向虚无。父 Agent 的叙述不是证据——你在重截图中看不到的所谓修复就是未解决。对评审轮每条材质修复给一行resolved/partial/unresolved挂钩新截图可见的具体表现机械应付位置动了但发现所指的品质仍缺席至多是 partial。点名修复批次自身引入的至多三个回归按同一矩阵规则评判其余一律不查——无新猎、无新检查。返回恰好两个章节verdict打分清单与remaining仍未关闭项或 clear以按剩余项重算的裁决词结尾同一四词词汇表。未解决或部分解决的材质发现永远不能重算为 ship此处赢得的 ship 只覆盖已评分的修复不覆盖整个表面——必须如实表述为恰好如此。十三、终审机制在构建流程中的位置new-work.md 的## 7. Inspect and finish描绘了完整闭环构建者批量截一轮图Webdesktop.png1440 宽整页、mobile.png390 宽加用户视口user-width.png→ comp-led 构建运行impeccable comp-diff生成差异证据 → spawn 终审评审者正式子 Agent 或退化的内联路径 degraded/finish-reviewer.md→ 按四个词行动recapture补图后整轮重审、rebuild立即执行重建并走全新完整评审、fix批量修复一次、重截同一视口、交回同一评审者评分、ship继续交接文档化documenter。两轮是无人值守运行的预算上限第二轮裁决仍有未关闭项时把表格交给用户决定。仓库测试 finish-handoff.test.mjs 即为该交接的合成后置检查点验证「评审已关闭、无 UI 编辑与截图需要」后的文档化收尾行为。十四、为什么这是一道门而不是一次检查把整个机制串起来看Finish Reviewer 的设计哲学可归纳为三条证据先于判断坏截图上不建矩阵坏证据上的裁决把破损洗白成批准——所以 recapture 永远优先。数量无法伪造质量72% 门禁、逐区域得分、TYPE/MATERIAL/GROUND 三行强制矩阵把「构建者自认为成功」与「测量显示成功」之间的鸿沟变成明文而数字测不到的字形性格与材质由无浏览器、零上下文继承的独立评审者用眼睛补上。词汇即权力边界四个裁决词构成完整词汇表父 Agent 无权发明新词、无权软化旧词输出契约限定恰好五节、至多八条修复——把「评审」从一次性意见变成可执行、可评分、可问责的交付门禁。对任何希望复用 Impeccable 工作流的构建者而言这份文档是理解「AI 生成的页面凭什么敢说完成」的钥匙不是模型自我感觉良好而是有一套独立于构建线程的评审契约从证据、持久化、保真度、天花板、契约承诺、真实性与工艺底线七个维度逐一问罪最后用四词裁决把结论钉死在案。【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考