上一篇我給出了審查 Codex 前端差異的順序先固定審查對象再把差異映射回任務(wù)目標(biāo)然后沿用戶路徑檢查正確性最后核對驗證證據(jù)。這篇繼續(xù)往下落整理成一份可以重復(fù)使用的清單。我把差異審查分成三層正確性目標(biāo)行為有沒有真正實現(xiàn)范圍實際修改有沒有遺漏或越界副作用沒有寫在目標(biāo)里的其他行為是否被改變。這三層看起來有重疊關(guān)注點其實不同。正確性問“新行為對不對”范圍問“改了該改的地方?jīng)]有”副作用問“其他行為還和以前一樣嗎”。只有三層都能給出證據(jù)我才會接受一批 AI 生成的前端差異。審查前先準(zhǔn)備四份基線清單不能脫離任務(wù)獨立使用。開始前我會準(zhǔn)備任務(wù)基線用戶要解決的問題目標(biāo)行為保持不變的行為正常、失敗和邊界驗收標(biāo)準(zhǔn)。范圍基線允許修改的位置修改前需要確認的公共位置明確禁止的目錄和無關(guān)工作。影響基線直接、間接和條件性調(diào)用方必須修改、必須回歸和明確排除的位置狀態(tài)、副作用、生命周期和樣式依賴。差異基線對比哪個分支、提交或任務(wù)開始前狀態(tài)當(dāng)前工作區(qū)是否包含用戶已有修改新增、刪除、重命名、暫存和未暫存文件怎樣處理。如果其中一份基線缺失清單中的很多問題都無法作出判斷。第一層正確性審查正確性不是看代碼有沒有明顯報錯而是檢查實現(xiàn)與需求之間的對應(yīng)關(guān)系。1. 目標(biāo)是否被完整實現(xiàn)每個用戶目標(biāo)是否有對應(yīng)差異是否只實現(xiàn)了可見入口沒有接通數(shù)據(jù)與結(jié)果是否只覆蓋正常路徑是否遺漏失敗、空值、權(quán)限或連續(xù)操作是否把“部分完成”寫成“全部完成”。2. 數(shù)據(jù)是否正確流動輸入來自正確來源嗎狀態(tài)是否仍有唯一可信來源頁面、組件和請求之間的數(shù)據(jù)轉(zhuǎn)換是否明確空值、默認值和可選字段是否保持語義保存后使用的是服務(wù)端結(jié)果、表單值還是舊列表數(shù)據(jù)刷新、排序、篩選和頁碼是否仍然一致。3. 組件契約是否正確Props 類型、必填和默認值是否符合需求Emits 名稱、時機和負載是否匹配調(diào)用方v-model是否正確雙向更新插槽作用域和默認內(nèi)容是否改變暴露方法的參數(shù)、返回值和調(diào)用時機是否兼容屬性和事件是否透傳到正確節(jié)點。4. 異步流程是否閉合Loading 在所有出口都能恢復(fù)嗎重復(fù)點擊是否受到控制請求失敗后狀態(tài)是否可繼續(xù)操作舊請求是否可能覆蓋新狀態(tài)關(guān)閉或卸載后異步結(jié)果會寫到哪里成功、失敗、取消和異常分支是否都有明確收尾。5. 生命周期是否正確初始化發(fā)生在首次掛載還是每次打開Props 變化后是否正確更新關(guān)閉時清理哪些狀態(tài)重新打開是否殘留舊數(shù)據(jù)和校驗路由返回、頁面緩存和組件重用是否恢復(fù)正確清理動作是否早于調(diào)用方需要的數(shù)據(jù)。6. 用戶體驗是否符合任務(wù)按鈕、提示、錯誤和空狀態(tài)是否明確禁用、隱藏和權(quán)限行為是否正確焦點、鍵盤和語義結(jié)構(gòu)是否退化移動或窄屏場景是否與改動有關(guān)文案是否準(zhǔn)確表達結(jié)果頁面是否出現(xiàn)新的閃爍、跳動或狀態(tài)錯位。正確性層的結(jié)論寫法我不會只寫“邏輯有問題”而會寫[優(yōu)先級] 問題標(biāo)題 觸發(fā)條件 當(dāng)前行為 期望行為 影響 代碼或運行證據(jù) 建議修正邊界它能讓下一輪修復(fù)直接對應(yīng)可驗證結(jié)果。第二層修改范圍審查正確實現(xiàn)一個需求不代表差異范圍合理。1. 是否遺漏必須修改的位置調(diào)用鏈中的直接消費者是否全部處理包裝組件是否繼續(xù)透傳舊契約公開類型和統(tǒng)一導(dǎo)出是否同步測試、示例和文檔是否因公開行為變化而需要更新多應(yīng)用或本地公共包是否存在真實消費者計劃中的文件是否有未出現(xiàn)的部分。2. 是否出現(xiàn)計劃外文件新文件為什么需要公共組件、請求層、路由和狀態(tài)是否得到確認配置、依賴和鎖文件變化是否與目標(biāo)直接相關(guān)生成文件是否應(yīng)該由腳本產(chǎn)生是否誤改舊版、示例或其他應(yīng)用。3. 是否夾帶無關(guān)重構(gòu)重命名是否為當(dāng)前目標(biāo)所需函數(shù)抽取是否改變職責(zé)邊界是否順手清理技術(shù)債是否把局部邏輯提前做成公共抽象是否替換項目已有寫法是否改變與需求無關(guān)的注釋、文案和樣式。4. 是否出現(xiàn)大面積格式差異格式化是否覆蓋整個文件導(dǎo)入排序是否使真實邏輯變化難以辨認行尾、編碼或換行符是否變化自動修復(fù)是否修改了任務(wù)外文件能否縮小為只包含目標(biāo)差異。5. 是否超出原定風(fēng)險等級局部任務(wù)是否觸碰公共契約單頁面任務(wù)是否進入全局狀態(tài)或路由守衛(wèi)內(nèi)部重構(gòu)是否改變用戶行為原計劃的驗證方式是否仍覆蓋新范圍是否需要重新規(guī)劃而不是繼續(xù)補代碼。范圍層最重要的問題我會讓每個差異塊完成一句話為了實現(xiàn)_這里必須改變 _如果不改會導(dǎo)致 ___。無法完成這句話的差異通常需要移出當(dāng)前任務(wù)或補充更強的依據(jù)。第三層副作用審查副作用是最容易在“功能已完成”之后留下的問題。1. 原有調(diào)用方是否被破壞沒有使用新能力的調(diào)用方是否保持原行為默認值變化是否影響未顯式傳值的位置事件時機和負載是否改變包裝組件是否隱藏了破壞性變化動態(tài)或條件性入口是否回歸。2. 共享狀態(tài)是否產(chǎn)生連帶影響修改是否寫入更多全局狀態(tài)其他頁面是否觀察到新值緩存、持久化和恢復(fù)邏輯是否一致狀態(tài)清理是否影響并行頁面新增副本是否可能與原狀態(tài)分叉。3. 請求與接口行為是否變化請求次數(shù)是否增加參數(shù)是否新增、刪除或改變默認值調(diào)用時機是否提前或延后失敗重試是否可能重復(fù)副作用是否繞過統(tǒng)一封裝返回數(shù)據(jù)是否被錯誤當(dāng)成完整模型。4. 路由、權(quán)限和可見性是否變化查詢參數(shù)和路由狀態(tài)是否被重置返回或刷新后能否恢復(fù)權(quán)限判斷是否移到錯誤層隱藏按鈕是否替代了真正的數(shù)據(jù)權(quán)限不同角色是否出現(xiàn)新的入口或缺失入口。5. DOM 與樣式是否發(fā)生隱性變化根節(jié)點和包裹層是否改變類名、深層選擇器和外部樣式是否失效屬性透傳位置是否變化定位、溢出和響應(yīng)式是否退化測試選擇器和可訪問名稱是否變化。6. 性能和資源是否退化是否增加重復(fù)請求和重復(fù)計算監(jiān)聽、訂閱、定時器是否正確清理是否引入無必要的深度監(jiān)聽列表項是否產(chǎn)生過多局部狀態(tài)大對象是否被反復(fù)復(fù)制或序列化新依賴是否增加構(gòu)建和運行負擔(dān)。這里不能憑感覺寫“性能可能變差”。如果沒有測量或明確機制證據(jù)應(yīng)把它寫成待驗證風(fēng)險而不是確定結(jié)論。7. 安全和數(shù)據(jù)邊界是否變化用戶輸入是否進入新的 HTML、URL 或命令上下文敏感字段是否被展示、記錄或緩存權(quán)限數(shù)據(jù)是否只在前端隱藏下載、跳轉(zhuǎn)和外鏈?zhǔn)欠裥ｒ炲e誤信息是否暴露不必要細節(jié)。這部分涉及具體項目時應(yīng)使用項目安全規(guī)范和真實接口要求不能憑通用清單替代專業(yè)安全審查。我怎樣給問題排序?qū)彶椴皇钦业迷蕉嘣胶谩＿^多低價值意見會掩蓋真正阻斷交付的問題。我會按影響排序。P0必須立即阻斷可能造成安全問題、數(shù)據(jù)破壞、嚴重權(quán)限越界或核心流程不可用。P1合入前必須修復(fù)穩(wěn)定觸發(fā)的功能錯誤、主要調(diào)用方破壞、狀態(tài)錯亂、錯誤數(shù)據(jù)提交或關(guān)鍵失敗路徑不可恢復(fù)。P2建議在當(dāng)前任務(wù)修復(fù)特定條件下的行為問題、明顯越界差異、維護成本較高的新模式或驗證缺口。P3非阻斷建議不影響當(dāng)前正確性和邊界的局部改進。它應(yīng)該與必須修復(fù)的問題分開必要時轉(zhuǎn)成后續(xù)任務(wù)。優(yōu)先級必須根據(jù)觸發(fā)條件和影響判斷不能只根據(jù)代碼寫法是否喜歡。審查意見怎樣寫得可執(zhí)行我使用下面的結(jié)構(gòu)## [P1] 保存成功事件在狀態(tài)清理后觸發(fā) ? - 位置目標(biāo)文件和緊鄰代碼范圍 - 觸發(fā)條件保存成功父頁面依賴當(dāng)前記錄完成局部刷新 - 當(dāng)前結(jié)果關(guān)閉流程先清理記錄事件負載缺失或讀取為空 - 預(yù)期結(jié)果父頁面在清理前取得本次保存對象失敗和主動關(guān)閉行為保持不變 - 證據(jù)事件觸發(fā)順序、父頁面監(jiān)聽邏輯、對應(yīng)頁面路徑 - 建議邊界只調(diào)整成功路徑順序不重構(gòu)彈窗公共 API - 驗證成功保存、失敗保留、主動關(guān)閉和連續(xù)編輯路徑這個結(jié)構(gòu)要求審查者承擔(dān)舉證責(zé)任而不是只表達偏好。如果我不能說明觸發(fā)條件、影響或證據(jù)就會把意見降為待確認問題而不是直接宣布代碼有錯。一份可直接使用的前端差異審查模板# 前端差異審查 ? ## 0. 審查范圍 - 對比基線 - 包含文件 - 排除的已有修改 - 新增、刪除、重命名和生成文件 ? ## 1. 任務(wù)與影響基線 - 目標(biāo)行為 - 保持不變 - 允許范圍 - 必須修改 - 必須回歸 - 明確排除 ? ## 2. 正確性 - [ ] 目標(biāo)完整實現(xiàn) - [ ] 數(shù)據(jù)和狀態(tài)正確 - [ ] 組件契約正確 - [ ] 異步流程閉合 - [ ] 生命周期正確 - [ ] 用戶體驗符合驗收 ? ## 3. 修改范圍 - [ ] 沒有遺漏必要位置 - [ ] 沒有未經(jīng)確認的計劃外文件 - [ ] 沒有無關(guān)重構(gòu)和抽象 - [ ] 沒有大面積格式噪聲 - [ ] 風(fēng)險等級與驗證計劃仍然匹配 ? ## 4. 副作用 - [ ] 原調(diào)用方保持兼容 - [ ] 共享狀態(tài)沒有連帶錯誤 - [ ] 請求與接口行為沒有意外變化 - [ ] 路由、權(quán)限和可見性保持正確 - [ ] DOM、樣式與可訪問性沒有退化 - [ ] 性能與資源風(fēng)險有證據(jù)或明確待驗證 - [ ] 安全與數(shù)據(jù)邊界沒有被擴大 ? ## 5. 驗證證據(jù) - 靜態(tài)檢查 - 測試 - 頁面路徑 - 完整差異復(fù)查 - 未驗證事項 ? ## 6. 發(fā)現(xiàn) ### P0 / P1 - 問題、觸發(fā)、影響、證據(jù)、建議邊界、驗證 ? ### P2 - 問題、觸發(fā)、影響、證據(jù)、建議邊界、驗證 ? ### P3 / 后續(xù)建議 - 建議及為什么不阻斷當(dāng)前交付 ? ## 7. 結(jié)論 - 可接受 / 修復(fù)后復(fù)審 / 需要重新規(guī)劃 / 證據(jù)不足 - 結(jié)論依據(jù)清單不能替代哪些判斷不能替代業(yè)務(wù)答案失敗后保留數(shù)據(jù)還是回滾保存后刷新還是局部替換需要真實需求決定。不能替代運行驗證靜態(tài)差異無法完整證明焦點、動畫、請求競態(tài)和連續(xù)交互正確。不能替代安全與性能專項檢查高風(fēng)險場景需要更具體的項目規(guī)范、工具和專業(yè)審查。不能把所有建議都變成當(dāng)前修改審查發(fā)現(xiàn)技術(shù)債很正常但當(dāng)前差異應(yīng)繼續(xù)保持單一目標(biāo)。非阻斷改進可以記錄為后續(xù)任務(wù)。最終結(jié)論不只有“通過”和“不通過”我會保留四種結(jié)論?？山邮苣繕?biāo)、范圍和副作用均有足夠證據(jù)未驗證項不阻斷當(dāng)前交付。修復(fù)后復(fù)審存在明確問題修復(fù)范圍可控修復(fù)后要重新檢查相關(guān)差異和行為路徑。需要重新規(guī)劃影響范圍擴大、公共契約變化或?qū)崿F(xiàn)方向與需求沖突局部補丁已經(jīng)不能安全解決。證據(jù)不足代碼看起來合理但關(guān)鍵測試、頁面路徑或環(huán)境條件無法驗證。此時不能把不確定性包裝成通過。寫在最后我給 Codex 前端改動做差異審查時會從三層檢查正確性目標(biāo)、狀態(tài)、契約、異步和生命周期是否正確范圍該改的有沒有漏不該改的有沒有進入差異副作用調(diào)用方、共享狀態(tài)、請求、路由、DOM、性能和安全邊界是否被意外改變。每條發(fā)現(xiàn)都要包含觸發(fā)條件、影響、證據(jù)、建議修正邊界和驗證方式再按真正的交付風(fēng)險排序。下一篇會進入第 2 周 Day 5為什么編譯或構(gòu)建通過仍然不等于任務(wù)完成。我會具體拆分類型檢查、Lint、單元測試、構(gòu)建和真實頁面驗證各自能證明什么、不能證明什么。本系列持續(xù)更新。后續(xù)會把今天的差異審查清單與自動檢查和頁面驗證連接起來完成從“代碼看起來對”到“結(jié)果有證據(jù)”的下一段閉環(huán)。參考資料OpenAI Codex 文檔限定代碼審查范圍、查看優(yōu)先級發(fā)現(xiàn)并使用行級反饋OpenAI Codex 文檔在 AGENTS.md 中配置接近代碼作用范圍的審查規(guī)則