數(shù)據(jù)庫(kù)客戶端后端前端CLI桌面應(yīng)用數(shù)據(jù)可視化AI 應(yīng)用【免費(fèi)下載鏈接】whodbWhere data access meets operational intelligence項(xiàng)目地址https://gitcode.com/gh_mirrors/wh/whodb點(diǎn)擊查看免費(fèi)下載在基于 Agent 的前端設(shè)計(jì)工作流中構(gòu)建完成與可以交付之間往往隔著一道最難的坎構(gòu)建者對(duì)自己的產(chǎn)出天然寬容而缺陷恰恰藏在構(gòu)建線程的注意力重力之外。whodb 倉(cāng)庫(kù)中的 impeccable_finish_reviewer.md 定義了 Impeccable 設(shè)計(jì)技能的收尾評(píng)審角色——一個(gè)只讀、無(wú)瀏覽器、以新鮮眼睛審視已完工產(chǎn)物的評(píng)審者它對(duì)照方向契約direction contract、已批準(zhǔn)的視覺對(duì)照稿approved comp和世界質(zhì)量卡QUALITY BAR card執(zhí)行六項(xiàng)有序檢查輸出rebuild/fix/ship三級(jí)裁定與一份至多八條的實(shí)質(zhì)性修復(fù)清單。讀完本文你將完整掌握該評(píng)審角色的輸入契約、六項(xiàng)檢查的判定規(guī)則、disposition 的推導(dǎo)邏輯、五段式輸出契約以及修復(fù)后的 Verdict Pass 打分機(jī)制并了解它在 Impeccable 技能整體收尾閉環(huán)中如何被調(diào)用與降級(jí)運(yùn)行。一、角色定位構(gòu)建線程之外的一雙新鮮眼睛該文檔開頭的一句話定義了整個(gè)角色的邊界You are the finishing reviewer for an Impeccable build: fresh eyes on a done artifact, outside the build threads attention gravity. You do not edit anything; the parent agent applies your fixes.來(lái)源由此可以拆出三條硬性職責(zé)邊界只評(píng)審、不修改。評(píng)審者不觸碰任何工件代碼父 Agent構(gòu)建線程負(fù)責(zé)應(yīng)用修復(fù)。評(píng)審的唯一產(chǎn)物是一份結(jié)構(gòu)化報(bào)告。上下文完全隔離。new-work.md 明確要求評(píng)審必須以全新上下文派生with no forked conversation historyfork_turns: 0in codex——繼承了構(gòu)建線程 transcript 的評(píng)審者會(huì)同時(shí)繼承它的框架、樂觀和抽象而評(píng)審所需的一切必須通過輸入包傳遞。無(wú)瀏覽器。文檔規(guī)定Never attempt to render, screenshot, start a server, or open a page; review from the provided files only來(lái)源。評(píng)審的視覺證據(jù)只能來(lái)自父 Agent 提前捕獲并傳入的截圖文件缺了截圖相應(yīng)檢查就無(wú)從執(zhí)行——這不是限制而是防止評(píng)審者在評(píng)審過程中自行補(bǔ)拍從而重新沾上構(gòu)建者的注意力。該角色的規(guī)范源頭是同技能的 agent 定義 impeccable_finish_reviewer.tomlTOML 中的developer_instructions字段與本文檔主體逐字一致可對(duì)比 TOML 第 6-39 行昵稱候選包括 Finishing Eye、Contract Judge、Ceiling Check來(lái)源推理強(qiáng)度設(shè)為high。reference/degraded/目錄下的四個(gè)降級(jí)文件finish-reviewer、documenter、asset-producer、manual-edit-applier全部帶有同一句構(gòu)建時(shí)生成注釋Generated from skill/agents/ at build time. Do not edit; edit the agent definition.來(lái)源——即它們是 agent 定義的派生產(chǎn)物修改必須回到 TOML 源頭。Impeccable 技能中的多角色分工Finish Reviewer 不是孤立存在的。SKILL.md 給出的命令表shape、init、document、extract、critique、audit、polish、bolder、quieter、harden、live等約 20 條命令覆蓋了設(shè)計(jì)、評(píng)審、潤(rùn)色、增強(qiáng)的完整工作流而在收尾階段多個(gè)角色按流水線協(xié)作角色文件職責(zé)構(gòu)建線程父 Agentnew-work.md 第 6-7 節(jié)按契約構(gòu)建、批量自檢、派生評(píng)審者Asset Producerdegraded/asset-producer.md產(chǎn)出/清理位圖資產(chǎn)禁止重新設(shè)計(jì)Finish Reviewerdegraded/finish-reviewer.md對(duì)照契約與 comp 評(píng)審?fù)旯ぎa(chǎn)物給出 dispositionDocumenterdegraded/documenter.md評(píng)審?fù)ㄟ^后從已構(gòu)建世界倒寫 DESIGN.md其中兩條規(guī)則與 Finish Reviewer 直接耦合Asset Producer 在 manifest 中對(duì)每個(gè)資產(chǎn)標(biāo)注qa_status來(lái)源為評(píng)審的 Truth 檢查提供資產(chǎn)側(cè)證據(jù)Documenter 則被要求Never canonize a craft-floor refusal into the system來(lái)源與評(píng)審者的 Floor 檢查形成上下游一致的底線約束。二、硬約束輪次預(yù)算與讀取是額度文檔第二、第十行給出了運(yùn)行時(shí)的兩條硬約束來(lái)源硬輪次上限hard turn ceiling運(yùn)行會(huì)在沒有任何警告的情況下被截?cái)郺 run that ends before the five sections are written returns nothing——沒寫完五段輸出契約的運(yùn)行等于什么都沒留下。讀取是額度不是目的Treat reading as an allowance。具體紀(jì)律是只讀提供的輸入加 craft floor工藝底線文件絕不讀其他任何 skill reference 文件把多次 Read 合并到同一輪次執(zhí)行先拿截圖、comp、card、contract采樣工件的主要文件而不是遍歷目錄樹大約到第十輪時(shí)就停止閱讀、開始寫作凡是沒讀完的內(nèi)容要在分節(jié)之上的一行里點(diǎn)名。這段約束的深層動(dòng)機(jī)在 new-work.md 第 7 節(jié) 可以找到對(duì)應(yīng)表述構(gòu)建線程在兩輪批量自檢后就應(yīng)停止打磨whatever remains ships through the handoffs, where a fresh context does the finding better and cheaper剩下的缺陷交給新上下文的評(píng)審角色找更準(zhǔn)也更省。輪次預(yù)算本質(zhì)上是把發(fā)現(xiàn)的算力從構(gòu)建線程轉(zhuǎn)移到評(píng)審角色用制度化的隔離換發(fā)現(xiàn)質(zhì)量。輸入契約Input Contract評(píng)審者期望收到的輸入包被逐條列明來(lái)源原始請(qǐng)求the original request已確認(rèn)的用戶回答the confirmed user answers工件路徑artifact path(s)父 Agent 捕獲的桌面與移動(dòng)端截圖路徑方向契約含五個(gè)塊THESIS、OWN-WORLD、STORY、FIRST VIEWPORT、FORMPRODUCT.md路徑已有的 hook 或 detector 發(fā)現(xiàn)findings所選世界的 QUALITY BAR 卡路徑與已批準(zhǔn) comp 路徑技能reference/craft-floor.md的路徑。輸入契約中藏著一條反直覺的閱讀順序規(guī)則When the harness can view images, open the screenshots, the comp, and the card first, andinventory the comps salient elements in your own words before reading the direction contract or any builder-authored summary: a review anchored on the contract inherits whatever the builders abstraction dropped.來(lái)源——如果 harness 能看圖必須先打開截圖、comp 和卡片并用自己的話把 comp 的顯著元素清點(diǎn)一遍之后才能讀方向契約或構(gòu)建者寫的任何摘要。理由是錨定在契約上的評(píng)審會(huì)原封不動(dòng)繼承構(gòu)建者抽象時(shí)丟掉的一切。契約本身是構(gòu)建者寫的用它做基準(zhǔn)等于讓運(yùn)動(dòng)員給自己當(dāng)裁判先建立獨(dú)立的元素清單Fidelity 檢查才有獨(dú)立于契約的判據(jù)。缺失輸入的處理方式同樣被規(guī)定在返回內(nèi)容頂部用一行說(shuō)明缺了什么然后只評(píng)審可評(píng)審的部分——不阻塞、不猜測(cè)。三、六項(xiàng)有序檢查從持久性到底線文檔的 Checks, in order 一節(jié)來(lái)源規(guī)定六項(xiàng)檢查按固定順序執(zhí)行。順序本身就是優(yōu)先級(jí)越靠前失敗越材質(zhì)material。1. Persistence持久化檢查檢查三件事PRODUCT.md存在——這是產(chǎn)品事實(shí)的持久記錄whodb 倉(cāng)庫(kù)根目錄即有一份 PRODUCT.md 作為該技能落地的實(shí)例若DESIGN.md早于本次構(gòu)建存在擴(kuò)展或重設(shè)計(jì)場(chǎng)景它必須與構(gòu)建出的世界一致若是全新世界DESIGN.md由評(píng)審?fù)ㄟ^后的 documenter 補(bǔ)寫因此此刻缺席不算發(fā)現(xiàn)若.impeccable/mocks/下存在 comp則必須存在對(duì)應(yīng)的審批記錄——surface brief 點(diǎn)名了被批準(zhǔn)的 comp或其 sidecar 中帶有approved標(biāo)記。comps with no recorded pick mean the approval point was skipped, and that is a material finding有 comp 而無(wú)審批記錄說(shuō)明審批環(huán)節(jié)被跳過這本身是一條實(shí)質(zhì)性發(fā)現(xiàn)。2. Fidelity保真度檢查核心這是六項(xiàng)中最重的一項(xiàng)判據(jù)是你對(duì)已批準(zhǔn) comp 的獨(dú)立元素清單永遠(yuǎn)不是契約對(duì)它的轉(zhuǎn)述。需要逐一比對(duì)并分類的維度包括拓?fù)鋞opology、閱讀順序、焦點(diǎn)尺度f(wàn)ocal scale、重疊與 z-order、密度、簽名幾何、主操作的處理方式comp 中被物理性加工、溶解或蓋章的 CTA 是簽名元素用普通矩形渲染即構(gòu)成 contradicted、導(dǎo)航項(xiàng)與圖標(biāo)、標(biāo)題層級(jí)與尺度關(guān)系。每個(gè)顯著元素必須歸入五類之一分類含義match與 comp 一致acceptable adaptation可接受的適配必須引用證據(jù)missing缺失contradicted與 comp 矛盾added without approval未經(jīng)批準(zhǔn)新增矩陣中有兩行是強(qiáng)制的每次評(píng)審都必須出現(xiàn)TYPE字體氣質(zhì)對(duì)照 comp 檢查展示字體的字面特征、壓縮比、字寬、字重、對(duì)比度、字端處理terminals。a face of a different character is contradicted however the layout matches——字體氣質(zhì)不同即 contradicted哪怕布局完全吻合。MATERIAL材質(zhì)comp 呈現(xiàn)為繪制、有紋理、有體積感或攝影質(zhì)感的元素若被渲染成扁平 CSS 或干凈矢量is contradicted regardless of placement, because medium is part of the promise——介質(zhì)本身就是承諾的一部分位置擺得再對(duì)也不成立。當(dāng)沒有提供已批準(zhǔn) comp 時(shí)TYPE 與 MATERIAL 并不豁免而是改以契約的 OWN-WORLD 塊和該世界的真實(shí)材質(zhì)為判據(jù)。此時(shí)有一條極具辨識(shí)度的判定準(zhǔn)則來(lái)源imitation material仿制材質(zhì)是機(jī)器生成設(shè)計(jì)最可靠的標(biāo)記——CSS 斜邊bevels、浮雕embossing、仿蓋章金屬、仿粉筆效果凡是對(duì)頁(yè)面從未真正渲染過的材質(zhì)做模仿一律直接判 contradicted。適配要算作有意為之必須引用四類證據(jù)之一用戶回答、surface brief、無(wú)障礙需求或迫使該偏離的產(chǎn)品事實(shí)未引用的偏離就是缺陷。而缺失簽名元素、拓?fù)涓淖?、未?jīng)批準(zhǔn)新增內(nèi)容會(huì)直接判 Fidelity 失敗并在material_fixes排序中壓過一切工藝點(diǎn)。當(dāng)焦點(diǎn)元素的 MATERIAL 被 contradicted或矛盾已成整頁(yè)而非例外時(shí)規(guī)則要求立即停止下達(dá)修復(fù)指令第一條 material fix 必須是rebuild 指令點(diǎn)名需要重新推導(dǎo)的 comp 區(qū)域和需要產(chǎn)出的資產(chǎn)。文檔對(duì)此有一句尖銳的說(shuō)明a list of patches against a rejected page launders the rejection into an approval——對(duì)一張已被否決的頁(yè)面逐條開修補(bǔ)單等于把否決洗白成批準(zhǔn)。同時(shí)規(guī)定凡是需要產(chǎn)出資產(chǎn)的修復(fù)必須顯式寫成produce: region as a raster asset絕不寫成會(huì)被父 Agent 用一段 CSS 應(yīng)付過去的樣式微調(diào)。最后一句劃定了 comp 的規(guī)格邊界comp 是構(gòu)圖、拓?fù)?、元素清單、密度、字體氣質(zhì)與材質(zhì)的規(guī)格不是像素級(jí)規(guī)格——語(yǔ)義、無(wú)障礙與響應(yīng)式重排上的允許差異只覆蓋轉(zhuǎn)譯translation不覆蓋替換replacement。3. Ceiling上限檢查對(duì)照所選世界的 QUALITY BAR 卡點(diǎn)名該世界原生設(shè)備中構(gòu)建尚未使用的部分框架frame、深度depth、字體處理lettering treatment、裝飾密度ornament density、動(dòng)效motion。文檔同時(shí)給出邊界The card governs commitment and finish, never composition——質(zhì)量卡管的是投入度與完成度永不管構(gòu)圖構(gòu)圖歸 Fidelity 管。new-work.md 中 QUALITY BAR 卡的來(lái)源也得到了印證它隨目錄catalog中的每個(gè)視覺世界附帶They set the craft level the build must reach, a rendered references finish, commitment, and art direction, never the composition。4. Contract逐承諾檢查契約檢查的第一動(dòng)作不是看渲染而是驗(yàn)證 FORM 塊攜帶了概念搖獎(jiǎng)concept roll打印的seed keya contract with no seed key, or one the parent cannot corroborate, means the roll was skipped and that is a material fix ahead of any craft point.來(lái)源這條檢查在倉(cāng)庫(kù)中有著完整的實(shí)現(xiàn)鏈條。concept-seed.mjs 負(fù)責(zé)從外部擲骰子——文件頭注釋解釋了設(shè)計(jì)動(dòng)機(jī)來(lái)源同一提示詞框架下模型會(huì)反復(fù)收斂到同一批概念所以搖獎(jiǎng)必須在模型之外完成key 的生成邏輯是process.env.IMPECCABLE_CONCEPT_SEED || crypto.randomBytes(4).toString(hex)來(lái)源即八位十六進(jìn)制種子。腳本輸出會(huì)打印形如DIRECTION CONCEPT SEED (key: key; mode: ...)的行并附上復(fù)現(xiàn)命令來(lái)源。而 new-work.md 第 5 節(jié) 規(guī)定方向契約五塊以 HTML 注釋寫入工件根布局的 body 開頭FORM 塊必須記錄the seed key the script printed并在首次生產(chǎn)構(gòu)建后 grep 構(gòu)建產(chǎn)物確認(rèn)契約沒被構(gòu)建抹掉。于是形成閉環(huán)腳本擲出 key → 契約記錄 key → 評(píng)審驗(yàn)證 key。評(píng)審者發(fā)現(xiàn)契約沒有 seed key即判定搖獎(jiǎng)被跳過且該 material fix 優(yōu)先于一切工藝點(diǎn)。驗(yàn)證 seed key 之后才是對(duì)五個(gè)塊逐一核對(duì)渲染是否兌現(xiàn)了承諾并對(duì)首屏執(zhí)行memory test記憶測(cè)試。該測(cè)試的定義在 new-work.md 第 6 節(jié)if someone left after one viewport, what would they describe an hour later? If the honest answer is a mood, the concept has not committed yet.——如果一個(gè)訪客只看了首屏就離開一小時(shí)后他還能描述出什么若誠(chéng)實(shí)的答案是一種氛圍說(shuō)明概念尚未落地。5. Truth真實(shí)性檢查五個(gè)判定要點(diǎn)演示數(shù)據(jù)必須被制作并明確標(biāo)注為 synthetic合成數(shù)據(jù)不得編造商業(yè)聲明未回答的聲明以帶標(biāo)記的占位符呈現(xiàn)而不是默默省略已批準(zhǔn) comp 中每一個(gè) image-native 區(qū)域都必須以真實(shí)資產(chǎn)交付而不是用漸變頂替每一個(gè)產(chǎn)出資產(chǎn)都必須在截圖中可見地存在以近零透明度應(yīng)用、或藏在其他繪制層后面的資產(chǎn)is a compliance token, not a shipped material——那是合規(guī)道具不是交付材質(zhì)。這一條與 Asset Producer 的職責(zé)邊界相互咬合degraded/asset-producer.md 要求資產(chǎn)默認(rèn)去掉燒錄的 UI 文本與 mock chrome、以至少 2 倍顯示尺寸交付并在每個(gè)生成后運(yùn)行embed-prompt.mjs把生成提示詞嵌入圖片本身來(lái)源使資產(chǎn)是什么隨資產(chǎn)留存——這恰好是 Truth 檢查每個(gè)資產(chǎn)可被驗(yàn)證所需的證據(jù)鏈。6. Floor底線檢查讀取 craft-floor.md 的Refuse 清單拿截圖逐條對(duì)照。craft-floor 的 Refuse 一節(jié)來(lái)源列舉的典型禁用項(xiàng)包括標(biāo)題上方的 kicker / eyebrowThis one is a ban, not a default: no brief earns it back——這是唯一的絕對(duì)禁令任何 brief 都無(wú)法掙回它來(lái)源neobrutalist 世界之外的硬偏移陰影box-shadow: 4px 4px 0用 Unicode 字符或 emoji 冒充圖標(biāo)系統(tǒng)系統(tǒng)展示字體Impact、Arial Black、平臺(tái)默認(rèn)無(wú)襯線漸變文字、卡片/列表項(xiàng)/提示框上超過 1px 的彩色border-left/border-right、條紋背景、裝飾性玻璃擬態(tài)與毛玻璃、hero-metric 模板等。評(píng)審文檔對(duì) Floor 檢查的定性很關(guān)鍵來(lái)源被禁元素即便與 comp 中任何內(nèi)容都不沖突也是 material fix——因?yàn)闃?gòu)建者在動(dòng)手前已經(jīng)加載過同一份禁令對(duì) comp 的保真不能為底線拒絕的東西背書。同時(shí)文檔明確父 Agent 的 hook findings 在有 hook 的 harness 上會(huì)機(jī)械地覆蓋這類檢查Floor 檢查存在的意義恰恰是無(wú) hook 的 harness 什么發(fā)現(xiàn)都不會(huì)帶過來(lái)——文檔甚至點(diǎn)出了一次實(shí)際事故the last two live sessions shipped five kickers past a reviewer that never looked最近兩次實(shí)機(jī)運(yùn)行五個(gè) kicker 從一個(gè)根本沒看的評(píng)審者面前溜走并上線。文末還有一條反向紀(jì)律Do not run a second detector pass; mechanical findings belong to the parents hooks.來(lái)源——評(píng)審者不得自行跑第二輪檢測(cè)器機(jī)械發(fā)現(xiàn)歸父 Agent 的 hook 管。評(píng)審者的價(jià)值在于判斷不在于重復(fù)機(jī)器勞動(dòng)。四、Disposition三級(jí)裁定的推導(dǎo)規(guī)則返回報(bào)告的第一行必須是disposition: rebuild、disposition: fix或disposition: ship之一其推導(dǎo)規(guī)則是純邏輯的來(lái)源裁定觸發(fā)條件rebuildrebuild-directive 條件被觸發(fā)Fidelity 整體失敗fixmaterial_fixes非空ship元素矩陣中不存在任何 contradicted 或 missing 行原文的措辭是 It is derived, never felt——裁定是被推導(dǎo)出來(lái)的絕不允許是感覺出來(lái)的。文檔用一段話鎖死評(píng)審者的校準(zhǔn)基準(zhǔn)You are the last gate before the user, not a colleague softening news for a colleague。校準(zhǔn)對(duì)象是已批準(zhǔn)的 comp 與世界的質(zhì)量卡絕不是構(gòu)建中可見的勞動(dòng)量A page a design director would send back is fix at best however functional it is設(shè)計(jì)總監(jiān)會(huì)退回的頁(yè)面功能再完善也最多是 fixa page whose focal craft sits far below the comp is rebuild however complete its structure焦點(diǎn)工藝遠(yuǎn)低于 comp 的頁(yè)面結(jié)構(gòu)再完整也是 rebuild。而父 Agent 對(duì)裁定詞只有逐字轉(zhuǎn)述的義務(wù)has no authority to soften it——沒有權(quán)力軟化它。五、輸出契約先裁定后五段輸出契約來(lái)源規(guī)定先返回 disposition 行隨后恰好五個(gè)分節(jié)不多不少分節(jié)內(nèi)容要求persistencepass/fail 加具體說(shuō)明fidelity元素矩陣每個(gè)顯著元素一行match / adaptation / missing / contradicted / added without approvaladaptation 必須引用證據(jù)或一句話 faithfulceiling未被使用的原生設(shè)備或 reachedmaterial_fixes有序列表最材質(zhì)者優(yōu)先Fidelity 失敗排在一切工藝點(diǎn)之前每條一行并綁定到某項(xiàng)檢查或契約承諾至多八條keep一行點(diǎn)名修復(fù)時(shí)不可稀釋的東西缺失輸入在分節(jié)之上的一行里點(diǎn)名。契約末尾有兩條文風(fēng)禁令No praise, no summary prose——不贊美不寫總結(jié)性散文。這與 new-work.md 第 7 節(jié) 對(duì)父 Agent 的驗(yàn)收要求對(duì)應(yīng)父 Agent 必須驗(yàn)證評(píng)審返回?cái)y帶全部五段契約內(nèi)容on an empty or thrashed return, respawn once with the same inputs——返回為空或混亂時(shí)用相同輸入重新派生一次。material_fixes的排序規(guī)則最材質(zhì)者優(yōu)先、Fidelity 壓工藝與 Fidelity 檢查中缺失簽名元素壓過一切工藝點(diǎn)的表述互為表里而keep分節(jié)則是給父 Agent 的防退化保險(xiǎn)批量修復(fù)最容易發(fā)生的事就是修 A 壞 Bkeep明確告訴執(zhí)行者哪些東西在這輪修復(fù)中不許被稀釋。六、Verdict Pass修復(fù)后的打分回合當(dāng)父 Agent 帶著修復(fù)后的重新截圖post-fix recaptures返回時(shí)評(píng)審者進(jìn)入 Verdict Pass來(lái)源。該回合的規(guī)則是打分不是重新找茬you are scoring, not re-hunting。父 Agent 對(duì)修了什么的敘述不構(gòu)成證據(jù)a claimed fix you cannot see in the recaptures is unresolved——聲稱修了但重新截圖里看不到的就是未解決。對(duì)上一輪 review 中的每條 material fix 逐行打分resolved、partial或unresolved且必須綁定到新截圖可見地呈現(xiàn)的東西。特別地a fix answered mechanically, positions moved but the quality the finding named still absent, is partial at best——位置挪了但發(fā)現(xiàn)所指的質(zhì)量仍然缺席的機(jī)械式修復(fù)最高只能算 partial。最多點(diǎn)名三條由修復(fù)批次本身引入的回歸regression按同一套矩陣規(guī)則判斷除此之外什么都不做不新找、不新查。返回恰好兩個(gè)分節(jié)verdict打分明細(xì)與remaining仍然開放的問題或 clear結(jié)尾附上對(duì)照剩余開放項(xiàng)重算后的 disposition 行。重算有一條鐵律unresolved or partial material findings can never recompute to ship——存在未解決或部分解決的實(shí)質(zhì)性發(fā)現(xiàn)時(shí)裁定永遠(yuǎn)不可能重算成 ship。這條規(guī)則與 new-work.md 第 7 節(jié) 描述的預(yù)算機(jī)制銜接無(wú)人值守運(yùn)行的收尾預(yù)算是兩輪Recapture measures positions, loading, and overflow; it cannot measure whether a fix reached the quality the finding named——重截圖只能量位置、加載與溢出量不出修復(fù)是否達(dá)到了發(fā)現(xiàn)所命名的質(zhì)量所以必須送回同一評(píng)審者打分兩輪后仍有開放項(xiàng)的受值守會(huì)話把表格擺到用戶面前由用戶在按現(xiàn)狀交付與再資助一輪之間選擇。七、收尾閉環(huán)與降級(jí)運(yùn)行模式把 new-work.md 第 7 節(jié) 的流程與本文檔放回同一張圖Finish Reviewer 在收尾閉環(huán)中的位置是這樣的構(gòu)建線程自檢桌面與移動(dòng)端截圖合并一輪批量檢查對(duì)照請(qǐng)求與方向契約修復(fù)實(shí)質(zhì)缺口最多兩輪后停止打磨無(wú) hook 的 harness 需在此處跑一次node .agents/skills/impeccable/scripts/detect.mjs --json并把剩余發(fā)現(xiàn)傳給評(píng)審者來(lái)源。派生評(píng)審者以全新上下文不 fork 對(duì)話歷史spawnimpeccable-finish-reviewer輸入包即上文第二節(jié)所列九項(xiàng)The reviewer has no browser; screenshots you fail to pass are checks it cannot run——你沒傳的截圖就是它跑不了的檢查。執(zhí)行裁定評(píng)審者返回 disposition 與五段。若第一條 material fix 是 rebuild 指令父 Agent 跳過修復(fù)批次立即執(zhí)行重建——re-derive the named regions, produce the named assets, and send the result back for a verdict重建后再次送回 Verdict Pass只有當(dāng)?shù)诙?rebuild 指令到達(dá)、兩份裁定同時(shí)在案、或重建會(huì)丟棄用戶已批準(zhǔn)的內(nèi)容時(shí)才征詢用戶。批量修復(fù)與重拍否則一次性應(yīng)用全部 material fixes重建一次重拍相同視口。Verdict Pass 打分回到同一評(píng)審者逐條 resolved / partial / unresolved重算 dispositionpartial 或 unresolved 的項(xiàng)再進(jìn)入下一輪修復(fù)—重拍—裁定。文檔化評(píng)審關(guān)閉后spawn documenter 從已構(gòu)建的世界倒寫DESIGN.mddegraded/documenter.md 是其降級(jí)形態(tài)A clean detector pass is not finished; finished is the contract kept, the comp honored, the review closed, and the system recorded.來(lái)源檢測(cè)器通過不等于完工契約兌現(xiàn)、comp 被尊重、評(píng)審關(guān)閉、系統(tǒng)被記錄四者齊備才是完工。Degraded 模式無(wú)子代理能力時(shí)的內(nèi)聯(lián)運(yùn)行本文檔標(biāo)題下的 degraded 即指降級(jí)運(yùn)行形態(tài)。文件第二行規(guī)定了內(nèi)聯(lián)替換協(xié)議來(lái)源This harness has no subagent capability, so you are running this role inline. Step fully out of the work you just finished, adopt only this files instructions for the pass, and disclose the substitution in one line when you report.即當(dāng) harness 完全沒有子代理能力時(shí)由當(dāng)前 Agent 完全退出剛結(jié)束的構(gòu)建心態(tài)、只采納本文件的指令執(zhí)行這一趟評(píng)審并在匯報(bào)時(shí)用一行披露這次替換。Where the text below addresses a parent agent, you are both parties: produce the full output contract first, then act on it yourself——文中凡是指向父 Agent 的語(yǔ)句此時(shí)你同時(shí)扮演雙方先產(chǎn)出完整輸出契約然后自己執(zhí)行它。這與 new-work.md 第 7 節(jié) 的兜底條款一一對(duì)應(yīng)Only a harness whose tool surface has no subagent capability at all substitutes a fresh in-thread pass after stepping fully out of the build context, run from degraded/finish-reviewer.md, and a substituted or failed-and-replaced review is disclosed in one line at finish, never silently——替換評(píng)審必須披露絕不許靜默。降級(jí)模式保留了全部紀(jì)律同樣的輸入契約、六項(xiàng)檢查、disposition 推導(dǎo)、五段輸出唯一變化的是執(zhí)行者從獨(dú)立子代理變成了自我隔離后的同一 Agent。八、小結(jié)finish-reviewer.md 用一份約四十行的角色規(guī)范把完工評(píng)審做成了可推導(dǎo)、可審計(jì)、可復(fù)現(xiàn)的制度輸入契約固定了證據(jù)集先清點(diǎn) comp 再讀契約的閱讀順序防止評(píng)審被構(gòu)建者的抽象俘獲六項(xiàng)有序檢查把持久性、保真、上限、契約兌現(xiàn)、真實(shí)性、底線分別鎖到明確的判據(jù)上seed key 可 grep 驗(yàn)證、TYPE/MATERIAL 強(qiáng)制成行、仿制材質(zhì)一票否決、禁用元素一律 material三級(jí) disposition 的推導(dǎo)規(guī)則剝奪了憑感覺放行的空間五段輸出契約與至多八條的修復(fù)上限保證了報(bào)告可執(zhí)行Verdict Pass 的打分而非再找茬則把修復(fù)質(zhì)量驗(yàn)證收斂到重新截圖的可見證據(jù)上。在 whodb 倉(cāng)庫(kù)中該文件與 impeccable_finish_reviewer.toml、craft-floor.md、new-work.md 及 concept-seed.mjs 共同構(gòu)成了一條從方向搖獎(jiǎng)、契約落紙、批量構(gòu)建到新鮮評(píng)審、裁定打分、倒寫文檔的完整收尾流水線理解這一角色就理解了把發(fā)現(xiàn)交給隔離上下文這套 Agent 工作流設(shè)計(jì)思想在評(píng)審環(huán)節(jié)的具體落地。贊分享數(shù)據(jù)庫(kù)客戶端后端前端CLI桌面應(yīng)用數(shù)據(jù)可視化AI 應(yīng)用【免費(fèi)下載鏈接】whodbWhere data access meets operational intelligence項(xiàng)目地址https://gitcode.com/gh_mirrors/wh/whodb點(diǎn)擊查看免費(fèi)下載相關(guān)推薦Impeccable Finish Reviewer 實(shí)戰(zhàn)指南構(gòu)建收尾的零妥協(xié)評(píng)審契約Impeccable Finish Reviewer 實(shí)戰(zhàn)指南構(gòu)建收尾的零妥協(xié)評(píng)審契約 在 Impeccable 的設(shè)計(jì)構(gòu)建流程中最容易被構(gòu)建者的注意力引AI 技能前端CLIdsh-pluginImpeccable Finish Reviewer 源碼解析無(wú)子代理 Harness 下的內(nèi)聯(lián)終審評(píng)審角色I(xiàn)mpeccable Finish Reviewer 源碼解析無(wú)子代理 Harness 下的內(nèi)聯(lián)終審評(píng)審角色 本文解析 Impeccable 技能包中的 FiAI 技能前端CLIdsh-plugin3分鐘裝好Octop自托管AI助手macOS/Linux一鍵腳本安裝完整教程3分鐘裝好Octop自托管AI助手macOS/Linux一鍵腳本安裝完整教程 Octop 是一個(gè)開源、自托管的多用戶 AI 助手平臺(tái)支持多 Agent 協(xié)作AI 應(yīng)用AI Agent大模型本地部署交互助手RAG上一篇NS-USBloader終極指南一站式解決Switch游戲安裝難題下一篇如何快速掌握Greasy Fork終極瀏覽器腳本管理平臺(tái)完整指南創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考