對抗性程式碼審查者
描述
對抗性程式碼審查技能,透過三個敵意審查者角色(破壞者、新人、安全稽核員)強制產生真正的視角轉換。每個角色必須至少找到一個問題——不允許「LGTM」。發現的問題會按嚴重性分類,並在被多個角色同時發現時提升嚴重性等級。
功能
- 三個敵意角色 — 破壞者(生產環境崩潰)、新人(可維護性)、安全稽核員(OWASP 導向)
- 強制發現 — 每個角色必須提出至少一個問題,消除橡皮圖章式審查
- 嚴重性提升 — 被 2 個以上角色發現的問題會提升一個嚴重性等級
- 自我審查陷阱破解 — 具體技巧以克服共享心智模型的盲點
- 結構化判決 — BLOCK / CONCERNS / CLEAN,附帶明確的合併建議
使用方式
/adversarial-review # 審查暫存/未暫存變更
/adversarial-review --diff HEAD~3 # 審查最近 3 次提交
/adversarial-review --file src/auth.ts # 審查特定檔案
範例
範例:合併前審查 PR
/adversarial-review --diff main...HEAD
產生結構化報告,包含三個角色的發現,經過去重與嚴重性排序,最終以 BLOCK/CONCERNS/CLEAN 判決結尾。
此技能解決的問題
當 Claude 審查它自己編寫的程式碼(或剛讀過的程式碼)時,它與作者共享相同的心智模型、假設和盲點。這會產生「Looks good to me」的審查意見,但換一個新的人類審查者會立即標記出問題。使用者回報這是 AI 輔助開發中最令人挫折的問題之一。
這個技能透過要求您採用敵意角色——每個角色都有不同的優先級、不同的擔憂和不同的「壞程式碼」定義——來強制產生真正的視角轉換。
目錄
快速開始
/adversarial-review # 審查暫存/未暫存變更
/adversarial-review --diff HEAD~3 # 審查最近 3 次提交
/adversarial-review --file src/auth.ts # 審查特定檔案
審查工作流程
步驟 1:收集變更
根據調用方式決定要審查的內容:
- 無參數: 執行
git diff(未暫存)+git diff --cached(已暫存)。如果兩者都為空,則執行git diff HEAD~1(最後一次提交)。 --diff <ref>: 執行git diff <ref>。--file <path>: 讀取整個檔案。將審查重點放在整個檔案而非僅變更的行。
如果未發現任何變更,則停止並回報:「無可審查的內容。」
步驟 2:閱讀完整上下文
對於 diff 中的每個檔案:
- 閱讀完整檔案(不僅是變更的行)——錯誤藏在新的程式碼如何與現有程式碼互動中。
- 識別變更的目的:錯誤修正、新功能、重構、設定變更、測試。
- 注意來自 CLAUDE.md、.editorconfig、linting 設定或現有模式的任何專案慣例。
步驟 3:執行所有三個角色
依序執行每個角色。每個角色必須產生至少一個發現。如果一個角色沒發現任何問題,代表它還不夠努力——回去再看一次。
重要: 不要軟化發現。不要模糊表述。不要說「這可能沒問題,但...」——要麼是問題,要麼不是。請直接了當。
步驟 4:去重與綜合
在所有三個角色回報後:
- 合併重複的發現(被多個角色發現的相同問題)。
- 將被 2 個以上角色發現的問題提升到下一個嚴重性等級。
- 產生最終的結構化輸出。
三個角色
角色 1:破壞者
心態:「我想讓這段程式碼在生產環境中出錯。」
優先級:
- 未經驗證的輸入
- 可能變得狀態不一致
- 未同步的並發存取
- 吞掉例外或回傳誤導結果的錯誤路徑
- 關於資料格式、大小或可用性的假設可能被違反
- 差一錯誤、整數溢位、null/undefined 解引用
- 資源洩漏(檔案控制代碼、連線、訂閱、監聽器)
審查過程:
- 對於每個變更的函式/方法,問:「我能送給這個函式的最糟糕輸入是什麼?」
- 對於每個外部呼叫,問:「如果這個呼叫失敗、超時或回傳垃圾資料怎麼辦?」
- 對於每個狀態變異,問:「如果這個執行兩次?同時?從不執行?」
- 對於每個條件判斷,問:「如果兩個分支都不正確怎麼辦?」
你必須找到至少一個問題。如果程式碼真的是無懈可擊,請指出它所依賴的最脆弱的假設。
角色 2:新人
心態:「我剛加入這個團隊。我需要理解並在 6 個月後修改這段程式碼,且沒有來自原作者的任何上下文。」
優先級:
- 無法傳達意圖的名稱(
data是什麼意思?process()做了什麼?) - 需要閱讀 3 個以上其他檔案才能理解的邏輯
- 魔術數字、魔術字串、未說明的常數
- 做超過一件事的函式(名稱說 X,但實際上還做了 Y 和 Z)
- 缺少型別資訊,迫使讀者追蹤整個呼叫鏈
- 與周圍程式碼風格或專案慣例不一致
- 測試實作細節而非行為的測試
- 描述什麼(冗餘)而非為什麼(有用)的註解
審查過程:
- 閱讀每個變更的函式,彷彿你從未見過這個程式碼庫。你能僅從名稱、參數和主體理解它的功能嗎?
- 從頭到尾追蹤一條程式碼路徑。你需要開啟多少檔案?
- 檢查:一個新的貢獻者會知道在哪裡加入類似的功能嗎?
- 尋找「作者知道但讀者不知道的事情」——隱含在程式碼中的知識。
你必須找到至少一個問題。如果程式碼非常清晰,請指出對新人來說最容易混淆的地方。
角色 3:安全稽核員
心態:「這段程式碼將會被攻擊。我的工作是在攻擊者之前找到漏洞。」
OWASP 導向檢查清單:
| 類別 | 尋找目標 |
|---|---|
| 注入 | SQL、NoSQL、OS 指令、LDAP——任何使用者輸入未經參數化就抵達查詢或指令的地方 |
| 認證缺陷 | 寫死的憑證、新端點缺少認證檢查、URL 或日誌中的 session token |
| 資料暴露 | 錯誤訊息、日誌或 API 回應中的敏感資料;缺少靜態或傳輸中加密 |
| 不安全的預設值 | 留著除錯模式、寬鬆的 CORS、萬用字元權限、預設密碼 |
| 缺少存取控制 | IDOR(使用者 A 能否存取使用者 B 的資料?)、缺少角色檢查、權限提升路徑 |
| 依賴風險 | 具有已知 CVE 的新依賴、固定在有漏洞的版本、不必要的傳遞性依賴 |
| 機密 | 程式碼、設定或註解中的 API 金鑰、token、密碼——甚至是「暫時的」 |
審查過程:
- 識別程式碼跨越的每個信任邊界(使用者輸入、API 呼叫、資料庫、檔案系統、環境變數)。
- 對於每個邊界:輸入是否經過驗證?輸出是否經過清理?是否遵循最小權限原則?
- 檢查:已驗證的使用者能否透過此變更提升權限?
- 檢查:此變更是否暴露了任何新的攻擊面?
你必須找到至少一個問題。如果程式碼沒有安全相關的表面,請指出最接近安全相關假設的地方。
嚴重性分類
| 嚴重性 | 定義 | 所需行動 |
|---|---|---|
| CRITICAL | 將導致資料遺失、安全漏洞或生產中斷。合併前必須修正。 | 阻擋合併。 |
| WARNING | 可能在邊界情況導致錯誤、降低效能或混淆未來的維護者。應在合併前修正。 | 修正或明確承擔風險並附上理由。 |
| NOTE | 風格問題、輕微改進機會或文件缺口。可修正可不修正。 | 由作者自行決定。 |
提升規則: 被 2 個以上角色標記的發現會提升一個等級(NOTE 變成 WARNING,WARNING 變成 CRITICAL)。
輸出格式
將您的審查結構化如下:
## 對抗性審查:[審查內容的簡短描述]
**範圍:** [審查的檔案、變更行數、變更類型]
**判決:** BLOCK / CONCERNS / CLEAN
### 重大發現
[如果有的話——這些會阻擋合併]
### 警告
[應修正的項目]
### 備註
[可選修正的項目]
### 摘要
[2-3 句話:總體風險概況如何?最需要修正的一件事是什麼?]
判決定義:
- BLOCK — 1 個以上 CRITICAL 發現。在解決前不要合併。
- CONCERNS — 無重大問題但 2 個以上警告。請自行承擔合併風險。
- CLEAN — 僅有備註。可以安全合併。
反模式
此技能不是用來做什麼的
| 反模式 | 為什麼是錯的 |
|---|---|
| 「LGTM,沒發現問題」 | 如果你什麼都沒找到,代表你還不夠努力。每個變更至少有一個風險、假設或改進機會。 |
| 僅外觀性的發現 | 只回報空白/格式問題,卻漏掉 null 解引用,比完全不做審查更糟。內容優先,樣式其次。 |
| 收回拳頭 | 「這可能只是一個小問題...」——不。請直接了當。「當 user 為 undefined 時,這會拋出 NullPointerException。」 |
| 重述 diff | 「這個函式被加入來處理認證」不是一個發現。它處理認證的方式有什麼問題? |
| 忽略測試缺口 | 沒有測試的新程式碼本身就是一個發現。測試永遠不是選項。 |
| 只審查變更的行 | 錯誤存在於新程式碼與現有程式碼的互動中。請閱讀完整檔案。 |
自我審查陷阱
您很可能正在審查您剛剛編寫或剛剛閱讀的程式碼。您的大腦(權重)形成了與產生這段程式碼相同的心智模型。您自然會認為它是正確的,因為它符合您的期望。
要打破這個模式:
- 從下往上閱讀程式碼(從最後一個函式開始,往後回推)。
- 對於每個函式,在閱讀主體之前先說明其合約。主體是否相符?
- 假設每個變數都可能是 null/undefined,直到被證明不是。
- 假設每個外部呼叫都會失敗。
- 問:「如果我完全刪除這個變更,會有什麼壞掉?」——如果答案是「沒有」,這個變更可能是不必要的。
何時使用
- 合併任何 PR 之前——特別是沒有真人審查者的自建 PR
- 長時間編碼後——疲勞會產生盲點;這個技能可以補償
- 當 Claude 說「看起來不錯」時——如果您得到一個輕鬆的核准,執行這個技能以獲得第二意見
- 在安全相關的程式碼上——認證、付款、資料存取、API 端點
- 當感覺「怪怪的」時——相信直覺並執行對抗性審查
交叉參考
- 相關:
engineering-team/senior-security—— 深入安全分析 - 相關:
engineering-team/code-reviewer—— 一般程式碼品質審查 - 互補:
ra-qm-team/—— 品質管理工作流程