Impeccable Finish Reviewer构建线程之外的最后一道路线评审闸门【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable导读ImpeccableThe design language that makes your AI harness better at design在每次构建的收尾阶段部署一名独立的「终审评审员」Finish Reviewer对已经完成的作品进行最终验收。本文基于仓库中的 impeccable-finish-reviewer.md 展开系统讲解该评审 Agent 的输入契约、七道按序执行的检查、四字处置词词汇表与五段式输出契约并结合 docs/COMP-FIDELITY.md、new-work.md 等源码与工程文档说明comp-diff度量、build-phase状态机、hero 阈值与检测器规则如何支撑这一机制。读完你将掌握一个无浏览器、只读、不编辑的评审 Agent 如何用可验证的证据链而非模型自我感觉为每次构建产出recapture / rebuild / fix / ship四字裁决。定位构建线程注意力引力之外的新鲜眼睛评审员的定义性约束在文档开头即被写死新鲜视角评审者是对一件已完工产物的新鲜眼睛处在构建线程的注意力引力之外。它不参与任何设计决策因此不会为构建者的抽象疏忽辩护。只读、零修改评审者不编辑任何东西由父代理parent应用你的修复。它的全部产出是裁决与修复清单。无浏览器绝不渲染、截图、启动服务器或打开页面只基于提供的文件评审。这意味着它的每一句判断都必须落在文件证据上无法用我看了看页面这种不可复现的方式蒙混。硬性轮次上限一轮运行超出约定的轮次会被无警告终止在约定的五个小节或 recapture 单节写完之前结束的运行什么都不返回。阅读被视为一种配额只读提供的输入加上 craft floor绝不读其他技能参考文件优先批量读取截图、comp、卡片和契约抽样读取产物的主文件而非遍历目录树大约在第十轮停止阅读并开始写作并在小节上方的单独一行中写明哪些内容未读。替换运行模式在不具备子 Agent 能力的 harness 中同一份规则以内联替换模式运行见 degraded/finish-reviewer.md——它要求评审者彻底走出刚完成的工作仅采用本文件的指令执行这一轮并在一行中披露这一替代。这在机制上保证了即使没有独立的子 Agent 进程评审者与构建者不是同一个注意力状态这一核心属性依然成立。该 Agent 的元数据frontmatter也印证了角色定位readonly: true、is_background: false、model: inherit。在 cursor-plugin/agents/impeccable-finish-reviewer.md 中则显式声明了effort: high、maxTurns: 30、可用工具Read, Bash, Glob, Grep以及候选昵称Finishing Eye / Contract Judge / Ceiling Checkskill/agents/impeccable-finish-reviewer.md为 Codex 变体codex-name: impeccable_finish_reviewer。不同平台的调用方式在 new-work.md 中有明确说明Cursor 中用/impeccable-finish-reviewerCodex 中用impeccable_finish_reviewerGitHub Copilot 中说 Use the impeccable-finish-reviewer agent。输入契约评审者能拿到什么不能自己发明什么输入契约严格界定了评审包的构成。预期输入包括输入类别具体内容原始请求最初的用户请求文本已确认的用户答案方向轮/表面轮中被用户确认过的问答记录产物路径待评审成品artifact的文件路径截图集父代理捕获的截图位于.impeccable/review/Web 为desktop.png与mobile.png原生为按设备类别命名的文件如phone.png、tablet.pngadaptive 按 OS 加后缀方向契约THESIS、OWN-WORLD、STORY、FIRST VIEWPORT、FORM 五个块产品文档PRODUCT.md 路径既有发现已存在的 hook 或 detector 发现如buried-raster、organic-clip-path质量天花板卡片所选世界world的 QUALITY BAR 卡片路径批准的 compcomp-led已批准的参考设计图路径code-led 构建没有改为把选定的决策 comp 作为独立标注的 critique-reference 输入传入且一切约束已批准 comp的规则对它不生效构建状态与度量comp-led.impeccable/build/state.json构建状态机、.impeccable/build/spec.json度量出的规格、.impeccable/review/diff/hero/与.impeccable/review/diff/final/两个 diff 目录diff 产物comp-led每个目录内含side-by-side.png、heatmap.png、regions/id.png配对裁剪图以及来自impeccable comp-diff的report.json含每区域得分与判定craft floor技能包的reference/craft-floor.md路径平台参考原生构建reference/ios.md/reference/android.md并附一行未运行 detector说明几条关键规则截图路径的权威性调用 brief 点名的截图路径在文件存在时具有权威性brief 未点名或点名路径缺失时去.impeccable/review/查找绝不发明文件名。原生构建的特殊性评审者需沿平台参考与 craft floor 一起阅读按平台自身惯例评判每一项检查将截图视为设备捕获并明白你的 floor 检查是这次构建唯一的 slop 闸门因为 detector 未运行。先看图再读契约当 harness 能查看图像时先打开截图、comp 和卡片用自己的话清点 comp 的关键元素再读方向契约或任何构建者撰写的摘要——锚定在契约上的评审会继承构建者的抽象所丢弃的东西。这一条直接呼应了 fidelity 检查中的核心方法以自己的元素清点为准而非契约对 comp 的转述。七道检查按序执行的验收流程评审按固定顺序执行七道检查0–6任何一道都可能单独决定最终处置词。检查 0证据Evidence——先验证截图再谈评分在所有其他检查之前先验证必需的截图存在且每张都有效必需集合平台的全视口集Webdesktop.png与mobile.png原生每个发布设备类别一张加 brief 点名要求的每一张含用户上报视口user-width.png。有效性无黑屏或空白区域内容与文件名宣称一致访问页显示 About 区块就是无效的文件声称整页时文档顶部可见尺寸与命名视口相符。缺失即失败必需截图缺失与畸形完全同等级失败没人捕获的视口就是没人检查的视口它不能发布。失败即换形任何截图失败整个评审改变形态——首行返回disposition: recapture随后只有一个recapture小节列出每个缺失或无效文件及有效捕获应显示的内容然后停止。绝不在畸形证据上建立矩阵由损坏截图得出的裁决等于把破损洗白成批准。父代理必须在有效截图上做一次完整复审而不是打分轮。检查 1持久化Persistence——构建的合法性审查PRODUCT.md 必须存在。comp-led 构建要求.impeccable/build/state.json存在且其comps或 surface 轮锁定 comp 时的skipped、spec、plates、hero各阶段均处于closed。跳过 comp 轮是重大发现无状态文件、或comps阶段从未 closed意味着构建仅凭世界描述运行该材料级发现优先于 craft。强制记录必须披露带forced记录的 closed 阶段除非用户在 packet 引用的原话中降级了 comp否则披露为材料级发现。hero 复现未经验证hero.gate.score低于 0.72 或状态文件缺失都是材料级发现且无论哪种情况.impeccable/review/hero-repro.png都必须存在。DESIGN.md 的时间语义当 DESIGN.md 早于本次构建扩展或重设计时它应与已构建世界匹配全新世界时它由 documenter 在本次评审之后编写因此此处缺失不算发现。批准记录.impeccable/mocks/下存在 comp 轮 comp 时必须同时存在批准记录点名已批准 comp 的 surface brief或其 sidecar 中的approved标志有 comp 轮 comp 而无记录在案的选择意味着批准点被跳过是材料级发现。而.impeccable/mocks/decision/下的文件是豁免的——它们是方向轮发下的一手牌产生于任何 comp 轮之前无论构建路径如何都不暗示批准code-led 构建则根本没有 comp 轮。这里的机制支撑来自docs/COMP-FIDELITY.md描述的分阶段状态机.impeccable/build/state.json按spec → plates → hero → sections → motion → responsive → review推进且仅由脚本推进--force --reason允许但必须记录、绝不静默status会为当前阶段打印 NEXT 行让评审者和构建者都能直接看到阶段与门槛。检查 2保真度Fidelity——从测量出发再判断测量不到的这是最重的一步分三段执行先读测量再判断其不能测量的部分。先读.impeccable/review/diff/final/report.json以及 hero 的每个被判missing或contradicted的区域除非regions/下的配对裁剪证明该分数是错的并说明原因否则就是该状态下的矩阵行即使被评match的区域评审者的眼睛仍要检查字形性格lettering character与材质material——数字不测量这些。用自己的元素清点对照已批准 comp绝不对照契约对它的转述拓扑结构、阅读顺序、焦点比例、重叠与 z 序、密度、标志性几何signature geometry、主行动primary action的处理方式——一个在 comp 上物理呈现、溶解或盖印的 CTA 是标志性元素其纯矩形演绎就是 contradicted——导航项与图标、标题层级与比例关系。每个显著元素必须归类为match、acceptable adaptation、missing、contradicted、或added without approval。矩阵中必有三行TYPE显示字体display lettering的性格、压缩度、宽度、字重、对比、字脚terminals对照 comp无论版式多吻合不同性格的字面就是 contradicted。MATERIALcomp 展示的是绘制的、有纹理的、有立体感的或照片类材质而元素被渲染为扁平 CSS 或干净矢量则无论位置如何都是 contradicted——媒介是承诺的一部分。GROUND页面的地面底色明度与色温对照 comp在工具允许时从两侧采样像素而非凭记忆判断在有纹理或瓷砖覆盖底色时读作最终屏幕结果地面比 comp 更暖或更冷都是 contradicted无论版式多忠实并特意提示要追查向既有渲染先例漂移的方向浅色地上的暖奶油色、深色地上的蓝黑石板色。无已批准 comp 时的降级规则TYPE 与 MATERIAL 不降级——对照契约的 OWN-WORLD 与世界真实材质判断且把伪造的物理性CSS 斜切、浮雕、模拟金属冲压或粉笔效果去模仿页面从未渲染的材质直接视为 contradicted模仿材质是机器生成设计最可靠的标记。GROUND 收窄但不消失OWN-WORLD 点名颜色时以该颜色为目标、同样适用暖冷判断未点名时没有 GROUND 权威评审就此说明而非给出判定因为评审者发明的目标会把检查变成口味。critique-reference compcode-led 构建或方向轮决策 comp是挑衅而非规格无元素矩阵、无改编引用、无资产义务其唯一贡献是图像敢做而构建未做之事值得采纳的敢进入material_fixes作为普通有序修复。改编的合法性只有当改编引用了迫使它的用户答案、surface brief、可及性需求或产品事实时才算有意改编未引用依据的偏离是缺陷。缺失标志性元素、改变拓扑、或未经批准新增内容——fidelity 失败且优先于 material_fixes 中的每一条 craft 点。重建指令rebuild directive当焦点元素focal element的 MATERIAL 被判定 contradicted、或矛盾成了全页状态而非例外时停止排列修补——第一条 material fix 必须是重建指令点名要重新推导的 comp 区域与要生产的资产针对被拒页面的修补清单等于把拒绝洗白成批准。需要生产资产的修复必须明说produce: as a raster asset绝不写成父代理会用 CSS 回应的样式调整。最后一句边界comp 是构图、拓扑、元素清点、密度、字形性格与材质的规格不是语义、可及性或响应式重排的像素规格且该容许涵盖翻译绝不涵盖替换。测量侧的实现依据见docs/COMP-FIDELITY.mdcomp-diff对 comp 与构建捕获做对齐缩放到 comp 宽度、取首视口行、SSIM 结构评分、颜色直方图与 Lab 主色调匹配、细节高频能量比、分段边界对齐按区域类型加权plate区域主要看细节、text区域看结构产出side-by-side.png、heatmap.png、regions/id.png与report.json判定词汇与评审者完全一致match / drift / missing / contradicted。comp-spec则把 comp 变成可度量的规格.impeccable/build/spec.jsonraster 类区域必须对应assets/plates/下的 plate 路径——规格即清单任何不在此列表中的东西在页面上都不存在。检查 3天花板Ceiling——对照世界质量条对照 QUALITY BAR 卡片点名构建未使用的世界原生设备native devices、框架frame、深度depth、字体处理lettering treatment、装饰密度ornament density、动效motion。卡片约束的是投入度与完成度commitment and finish绝不约束构图。即质量天花板管做得够不够到位而构图对错由 fidelity 检查裁决二者权责分离。检查 4契约逐条兑现Contract, promise by promise先验证 FORM 携带概念掷点concept roll打印的种子键seed key无种子键、或父代理无法佐证的契约意味着掷点被跳过是一条先于任何 craft 点的材料级修复。然后对五个块THESIS、OWN-WORLD、STORY、FIRST VIEWPORT、FORM逐条问渲染是否兑现了承诺对第一视口应用记忆测试memory test——凭记忆回想页面后与截图比对测试元素是否真的留下了印象。这一检查在 code-led 构建中尤其关键new-work.md明确code-led 构建按契约跳过 comp 轮而非因漂移跳过它本应承载的野心活在方向契约的 FIRST VIEWPORT 块与命名的标志性交互中finish reviewer 在行为中审计这些承诺。检查 5真实性Truth——没有编造的承诺演示数据必须是作者标注的合成数据demonstration data authored and labeled synthetic。无编造的商业声明未答复的声明以标注的占位符呈现而非作为遗漏。每个 raster 区域按规格发货为其 plate规格点名文件、页面引用它、该区域的 diff 行不是missing不能用渐变、内联 SVG 或高顶点clip-path顶替。每个已生产资产必须肉眼可见地出现在截图中以近零透明度应用或埋在水洗wash后面的资产是合规令牌不是已发货的材质。packet 中 detector 的buried-raster与organic-clip-path发现直接转为材料级修复。对应检测器规则定义同样见于docs/COMP-FIDELITY.mdorganic-clip-path拦截 10 个离网格顶点的clip-path: polygon()或 3 曲线段的clip-path: path()几何裁剪如切角、对角线、六边形、箭头通过buried-raster拦截被 0.9 alpha 渐变水洗覆盖且无混合模式的url()图层或透明度 0.15 的 raster 背景/img。检查 6工艺底线Floor——人眼复查的 Refuse 清单阅读 craft floor 的 Refuse 清单并对照截图检查kicker 与 eyebrow、新粗野主义neobrutalist世界之外的硬偏移阴影、字形图标glyph icons、系统显示字体、渐变文字、侧条纹等等。关键规则被禁元素即使与 comp 中任何元素都不匹配也是材料级修复——构建者在写它之前加载了同一份禁令对 comp 的忠实不能授权 floor 所拒绝的东西。文档还点明了本检查存在的原因父代理的 hook 发现会在运行 hook 的地方机械覆盖这一点此检查存在是因为无 hook 的 harness 到达你这里时什么发现都没有而最近两个 live 会话在从未看过一眼的评审者眼皮底下发货了五个 kicker。这解释了为什么 floor 必须由评审者本人亲自执行而不是依赖自动检测。同时文档明确不要运行第二遍 detector机械发现属于父代理的 hooks。评审者与自动检测的分工由此清晰机械的交给 hook判断的留在人眼。处置词四个词构成的整个词汇表返回的首行必须是四者之一disposition: recapture、disposition: rebuild、disposition: fix、disposition: ship。这四个词就是全部词汇绝不发明其他词。词是推导出来的不是感觉出来的处置词触发条件recapture证据检查失败rebuild重建指令条件触发fidelity 整页失败或焦点元素材质被拒fixmaterial_fixes非空ship仅当矩阵中没有 contradicted 或 missing 行校准方向明确你是用户面前的最后一道闸门不是给同事软化消息的同事对照已批准 comp 与世界质量条校准绝不对照构建中可见的努力校准。设计总监会退回的页面无论多可用都是 fix 顶格焦点工艺远低于 comp 的页面无论结构多完整都是 rebuild。父代理逐字报告你的处置词且无权软化它。对应的执行语义在new-work.mdL139 起有完整说明rebuild时跳过修复批次立即执行重建——重新推导点名区域、生产点名资产送回做全新完整评审而绝非判定轮recapture时按捕获有效性规则重新捕获后对新增证据做完整复审。输出契约五段式返回结构首行处置词之后恰好五个小节persistence——pass/fail 并给出具体说明。fidelity——元素矩阵每个显著元素的 match / adaptation / missing / contradicted / added without approval改编引用其证据或写 faithful。ceiling——未使用的原生设备或写 reached。material_fixes——按材料级程度排序fidelity 失败优先于 craft每条一行、对应某检查或契约承诺至多八条。keep——一行点名修复过程中不得被稀释的东西。recapture返回用检查 0 的单个recapture小节替换全部五个小节。缺失输入在小节上方一行点名。无赞扬、无总结性散文——输出契约只承载判断。复核轮Verdict Pass评分而非重新狩猎当父代理带着修复后的重新捕获post-fix recaptures返回时评审者进入评分模式而非重新狩猎模式。三种条件会把你带出评分模式复核捕获未通过检查 0 → 与评审轮完全一样返回disposition: recapture紧随你的重建指令之后的返回 → 全新完整评审重建整区替换仅给指令打分会放过重建遗漏的一切携带用户提供截图、且与先前裁决矛盾的 packet → 以用户捕获为主要证据的全新完整评审用户对真实页面的截图胜过父代理搭设的每张捕获。评分规则父代理在同一批截图文件上重新捕获因此重读那些确切路径你发明的带轮次戳的文件名指向虚无。父代理对修复内容的叙述不是证据你在复核捕获中看不到的声称修复就是未解决unresolved。对评审轮的每条材料修复一行resolved/partial/unresolved并绑定到新截图肉眼可见的内容机械应答的修复——位置动了但发现点名的质量仍然缺席——至多算 partial。然后点名修复批次自身引入的至多三条回归用同一套矩阵规则判定别无其他不再狩猎、不再新增检查。返回恰好两个小节verdict评分列表与remaining仍悬而未决的或 clear并以针对剩余项重算的处置词结尾仍用那四个词。硬约束unresolved 或 partial 的材料发现永远不能重算为 ship且在此赢得的 ship 只覆盖已评分的修复不覆盖整个表面必须如此陈述。机制全貌测量、状态机与检测器如何支撑这台人眼把评审契约放回工程上下文其可验证性建立在三层机制之上详见 docs/COMP-FIDELITY.md测量层comp-diff把保真度从模型凭记忆自评变成对像素的机械比对结构 SSIM、颜色直方图与 Lab 主色调、细节能量、分段对齐并产出评审者可直接消费的report.json与配对裁剪comp-spec把 comp 变成带区域种类plate / image / texture / text / control / chrome与 plate 路径的规格文件。评审契约中先读报告、再用自己的眼睛补足数字测不到的字形与材质正是这一分工的体现。状态机层build-phase把构建推进为磁盘上的状态机每阶段有门槛plates 门槛、hero 门槛 0.72 等forced必须记录。评审的 Persistence 检查因此可以直接读状态文件验证comp 轮是否真的跑过、hero 是否真的复现过而不是听构建者叙述。检测器层buried-raster、organic-clip-path等规则机械覆盖材质类反模式评审的 Truth 与 Floor 检查引用这些发现为材料级修复而 hook 机制如 .cursor/hooks.json 中的hook-before-edit入口在 harness 侧提供机械覆盖评审者明确不再重复运行 detector。这条测量先行、人眼终审的流水线配合 new-work.md 中spawn 评审者 → 按处置词行动的执行闭环构成了 Impeccable 收尾阶段的完整质量闸门每一次构建的最终交付判定都锚定在.impeccable/下可复核的状态、规格、diff 与截图文件上而不是任何一方的口头陈述。【免费下载链接】impeccableThe design language that makes your AI harness better at design.项目地址: https://gitcode.com/GitHub_Trending/im/impeccable创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考