工程師用 AI 產生程式碼之後,最先壞掉的不是程式品質,是審查流程的假設。過去 reviewer 默認「寫的人懂自己寫了什麼」,現在這個前提不一定成立。我把這一年看到的錯法整理成四種,每種都附根因和改法,PR 範本跟審查規則改幾個欄位就能補上。
01錯法一:PR 變大,reviewer 只看綠燈
AI 補全讓一次提交的行數明顯變多,一個原本兩百行的功能,可能變成帶著測試、型別定義、輔助函式一起進來的大 PR。reviewer 時間沒變多,結果就是看 CI 是綠的、掃一下命名,直接 approve。
根因是審查容量沒有跟產出速度一起調整。改法是設硬上限:單一 PR 超過約定行數就要拆,自動產生的檔案(migration、lock 檔、snapshot)另外標記不計入。上限是多少由團隊自己訂,重點是寫進 CONTRIBUTING.md,而不是靠默契。
02錯法二:作者講不出這段為什麼這樣寫
review 時問「這裡為什麼用遞迴」,作者回「AI 給的,跑起來沒問題」。這是最危險的狀況,因為之後要維護的人是他,不是工具。半年後出 bug,沒有人能還原當初的設計意圖。
我的規則是:作者必須能口頭解釋每一段邏輯,講不出來的段落就退回。PR 範本加一個欄位「AI 產生範圍」,請作者勾選哪幾個檔案或函式主要由工具產生,reviewer 就知道哪裡要多問兩句。這不是要懲罰用工具的人,是讓審查資源用在對的地方。
03錯法三:看起來合理的依賴與 API
AI 產生的程式碼常常引用一個名字很像真的套件,或呼叫某個函式庫裡根本不存在的參數。型別檢查有時抓得到,有時要到執行期才炸。更麻煩的是它真的存在、但是很久沒維護的套件。
根因是審查清單沒有把「新增依賴」當成獨立檢查項目。改法有三個:package.json、requirements.txt 這類檔案有變動時,自動要求第二位 reviewer;新增套件要在 PR 說明附上官方文件連結與最近一次發版日期;授權條款不明的一律不收。我以前建資安制度時,第三方元件本來就要列冊管理,現在只是把這條規則搬到 PR 層級執行。
04錯法四:機密跟著程式碼一起貼出去
為了讓 AI 看懂錯誤,工程師把整段設定檔、連線字串、客戶資料樣本貼進對話視窗。這件事不會出現在 PR 裡,所以 code review 完全看不到。
這一條要在審查流程之外處理。第一,寫一頁「可以貼與不能貼」清單:.env、憑證、正式環境資料庫內容、客戶識別資料都不能貼。第二,在 pre-commit hook 加上 secret 掃描,至少擋住寫死在程式裡的金鑰。第三,正式環境資料要用遮罩後的樣本除錯。這些做法本來就是資安管理的基本盤,AI 只是讓違規變得更容易、更沒感覺。
05審查規則修改清單
整理成可以直接改進 repo 的五項:1. PR 範本新增「AI 產生範圍」與「我能解釋每一段邏輯」兩個勾選欄。2. 設定單一 PR 行數上限,超過就拆。3. 依賴檔有變動時,CODEOWNERS 自動加一位資深 reviewer。4. pre-commit 加 secret 掃描。5. 每月抽一個已合併的 PR 回頭看,檢查審查有沒有漏。
驗收方式也要先講好。跑四週後看兩件事:被退回要求拆分的 PR 數量,以及上線後追溯到「審查沒發現」的 bug 數量。前者一開始會變多,這是正常的;後者沒有下降,就代表規則改了但沒有人照做。