Communitygithub.com

SamuelChien/mega-skills-collection

對抗性程式碼審查,打破自我審查的單一文化。在需要對近期變更進行真正批判性審查、合併 PR 前,或懷疑 Claude 對程式碼品質過於寬容時使用。透過敵意審查者角色強制視角轉換,找出作者與審查者共同心智模型下的盲點。

mega-skills-collection 是什麼?

這個技能透過三個敵意審查者角色(破壞者、新人、安全稽核員)來執行對抗性程式碼審查,強制產生真正的視角轉換。每個角色都必須至少找到一個問題,杜絕「LGTM」的橡皮圖章式審查。發現的問題會按嚴重性分類,並在被多個角色同時發現時提升嚴重性等級。它支援多種使用方式:審查暫存/未暫存變更、特定提交範圍或單一檔案。輸出結構化報告,包含 BLOCK / CONCERNS / CLEAN 的明確合併建議。這個技能特別適合在合併 PR 前、長時間編碼後、或當 Claude 給出過於寬鬆的審查意見時使用,能有效打破自我審查陷阱,避免因共享心智模型而產生的盲點。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/SamuelChien/mega-skills-collection/tree/HEAD/adversarial-reviewer

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

對抗性程式碼審查者

描述

對抗性程式碼審查技能,透過三個敵意審查者角色(破壞者、新人、安全稽核員)強制產生真正的視角轉換。每個角色必須至少找到一個問題——不允許「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 輔助開發中最令人挫折的問題之一。

這個技能透過要求您採用敵意角色——每個角色都有不同的優先級、不同的擔憂和不同的「壞程式碼」定義——來強制產生真正的視角轉換。

目錄

  1. 快速開始
  2. 審查工作流程
  3. 三個角色
  4. 嚴重性分類
  5. 輸出格式
  6. 反模式
  7. 何時使用

快速開始

/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 中的每個檔案:

  1. 閱讀完整檔案(不僅是變更的行)——錯誤藏在新的程式碼如何與現有程式碼互動中。
  2. 識別變更的目的:錯誤修正、新功能、重構、設定變更、測試。
  3. 注意來自 CLAUDE.md、.editorconfig、linting 設定或現有模式的任何專案慣例。

步驟 3:執行所有三個角色

依序執行每個角色。每個角色必須產生至少一個發現。如果一個角色沒發現任何問題,代表它還不夠努力——回去再看一次。

重要: 不要軟化發現。不要模糊表述。不要說「這可能沒問題,但...」——要麼是問題,要麼不是。請直接了當。

步驟 4:去重與綜合

在所有三個角色回報後:

  1. 合併重複的發現(被多個角色發現的相同問題)。
  2. 將被 2 個以上角色發現的問題提升到下一個嚴重性等級。
  3. 產生最終的結構化輸出。

三個角色

角色 1:破壞者

心態:「我想讓這段程式碼在生產環境中出錯。」

優先級:

  • 未經驗證的輸入
  • 可能變得狀態不一致
  • 未同步的並發存取
  • 吞掉例外或回傳誤導結果的錯誤路徑
  • 關於資料格式、大小或可用性的假設可能被違反
  • 差一錯誤、整數溢位、null/undefined 解引用
  • 資源洩漏(檔案控制代碼、連線、訂閱、監聽器)

審查過程:

  1. 對於每個變更的函式/方法,問:「我能送給這個函式的最糟糕輸入是什麼?」
  2. 對於每個外部呼叫,問:「如果這個呼叫失敗、超時或回傳垃圾資料怎麼辦?」
  3. 對於每個狀態變異,問:「如果這個執行兩次?同時?從不執行?」
  4. 對於每個條件判斷,問:「如果兩個分支都不正確怎麼辦?」

你必須找到至少一個問題。如果程式碼真的是無懈可擊,請指出它所依賴的最脆弱的假設。


角色 2:新人

心態:「我剛加入這個團隊。我需要理解並在 6 個月後修改這段程式碼,且沒有來自原作者的任何上下文。」

優先級:

  • 無法傳達意圖的名稱(data 是什麼意思?process() 做了什麼?)
  • 需要閱讀 3 個以上其他檔案才能理解的邏輯
  • 魔術數字、魔術字串、未說明的常數
  • 做超過一件事的函式(名稱說 X,但實際上還做了 Y 和 Z)
  • 缺少型別資訊,迫使讀者追蹤整個呼叫鏈
  • 與周圍程式碼風格或專案慣例不一致
  • 測試實作細節而非行為的測試
  • 描述什麼(冗餘)而非為什麼(有用)的註解

審查過程:

  1. 閱讀每個變更的函式,彷彿你從未見過這個程式碼庫。你能僅從名稱、參數和主體理解它的功能嗎?
  2. 從頭到尾追蹤一條程式碼路徑。你需要開啟多少檔案?
  3. 檢查:一個新的貢獻者會知道在哪裡加入類似的功能嗎?
  4. 尋找「作者知道但讀者不知道的事情」——隱含在程式碼中的知識。

你必須找到至少一個問題。如果程式碼非常清晰,請指出對新人來說最容易混淆的地方。


角色 3:安全稽核員

心態:「這段程式碼將會被攻擊。我的工作是在攻擊者之前找到漏洞。」

OWASP 導向檢查清單:

類別尋找目標
注入SQL、NoSQL、OS 指令、LDAP——任何使用者輸入未經參數化就抵達查詢或指令的地方
認證缺陷寫死的憑證、新端點缺少認證檢查、URL 或日誌中的 session token
資料暴露錯誤訊息、日誌或 API 回應中的敏感資料;缺少靜態或傳輸中加密
不安全的預設值留著除錯模式、寬鬆的 CORS、萬用字元權限、預設密碼
缺少存取控制IDOR(使用者 A 能否存取使用者 B 的資料?)、缺少角色檢查、權限提升路徑
依賴風險具有已知 CVE 的新依賴、固定在有漏洞的版本、不必要的傳遞性依賴
機密程式碼、設定或註解中的 API 金鑰、token、密碼——甚至是「暫時的」

審查過程:

  1. 識別程式碼跨越的每個信任邊界(使用者輸入、API 呼叫、資料庫、檔案系統、環境變數)。
  2. 對於每個邊界:輸入是否經過驗證?輸出是否經過清理?是否遵循最小權限原則?
  3. 檢查:已驗證的使用者能否透過此變更提升權限?
  4. 檢查:此變更是否暴露了任何新的攻擊面?

你必須找到至少一個問題。如果程式碼沒有安全相關的表面,請指出最接近安全相關假設的地方。

嚴重性分類

嚴重性定義所需行動
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「這個函式被加入來處理認證」不是一個發現。它處理認證的方式有什麼問題?
忽略測試缺口沒有測試的新程式碼本身就是一個發現。測試永遠不是選項。
只審查變更的行錯誤存在於新程式碼與現有程式碼的互動中。請閱讀完整檔案。

自我審查陷阱

您很可能正在審查您剛剛編寫或剛剛閱讀的程式碼。您的大腦(權重)形成了與產生這段程式碼相同的心智模型。您自然會認為它是正確的,因為它符合您的期望。

要打破這個模式:

  1. 從下往上閱讀程式碼(從最後一個函式開始,往後回推)。
  2. 對於每個函式,在閱讀主體之前先說明其合約。主體是否相符?
  3. 假設每個變數都可能是 null/undefined,直到被證明不是。
  4. 假設每個外部呼叫都會失敗。
  5. 問:「如果我完全刪除這個變更,會有什麼壞掉?」——如果答案是「沒有」,這個變更可能是不必要的。

何時使用

  • 合併任何 PR 之前——特別是沒有真人審查者的自建 PR
  • 長時間編碼後——疲勞會產生盲點;這個技能可以補償
  • 當 Claude 說「看起來不錯」時——如果您得到一個輕鬆的核准,執行這個技能以獲得第二意見
  • 在安全相關的程式碼上——認證、付款、資料存取、API 端點
  • 當感覺「怪怪的」時——相信直覺並執行對抗性審查

交叉參考

  • 相關:engineering-team/senior-security —— 深入安全分析
  • 相關:engineering-team/code-reviewer —— 一般程式碼品質審查
  • 互補:ra-qm-team/ —— 品質管理工作流程

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

SamuelChien/mega-skills-collection

Security audit, hardening, threat modeling (STRIDE/PASTA), Red/Blue Team, OWASP checks, code review, incident response, and infrastructure security for any project.

SamuelChien/mega-skills-collection

Arquitecto de Soluciones Principal y Consultor Tecnológico de Andru.ia. Diagnostica y traza la hoja de ruta óptima para proyectos de IA en español.

SamuelChien/mega-skills-collection

Ingeniero de Sistemas de Andru.ia. Diseña, redacta y despliega nuevas habilidades (skills) dentro del repositorio siguiendo el Estándar de Diamante.

SamuelChien/mega-skills-collection

Estratega de Inteligencia de Dominio de Andru.ia. Analiza el nicho específico de un proyecto para inyectar conocimientos, regulaciones y estándares únicos del sector. Actívalo tras definir el nicho.

SamuelChien/mega-skills-collection

2D game development principles. Sprites, tilemaps, physics, camera.

SamuelChien/mega-skills-collection

3D game development principles. Rendering, shaders, physics, cameras.

SamuelChien/mega-skills-collection

Expert in building 3D experiences for the web - Three.js, React Three Fiber, Spline, WebGL, and interactive 3D scenes. Covers product configurators, 3D portfolios, immersive websites, and bringing depth to web experiences.

SamuelChien/mega-skills-collection

Accessibility audit skill for scanning, fixing, and verifying WCAG 2.2 Level A and AA compliance across React, Next.js, Vue, Angular, Svelte, and plain HTML codebases. Use when auditing accessibility, fixing a11y violations, checking color contrast, generating compliance reports, or integrating accessibility checks into CI/CD pipelines.

SamuelChien/mega-skills-collection

Ab Test Analyzer - Auto-activating skill for Data Analytics. Triggers on: ab test analyzer, ab test analyzer Part of the Data Analytics skill category.

SamuelChien/mega-skills-collection

A B Test Config Creator - Auto-activating skill for ML Deployment. Triggers on: a b test config creator, a b test config creator Part of the ML Deployment skill category.

SamuelChien/mega-skills-collection

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "conversion experiment," "statistical significance," or "test this." For tracking implementation, see analytics-tracking.

SamuelChien/mega-skills-collection

Acceptance Criteria Creator - Auto-activating skill for Enterprise Workflows. Triggers on: acceptance criteria creator, acceptance criteria creator Part of the Enterprise Workflows skill category.

SamuelChien/mega-skills-collection

Use when a coding task should be driven end-to-end from issue intake through implementation, review, deployment, and acceptance verification with minimal human re-intervention.

SamuelChien/mega-skills-collection

Accessibility Audit Runner - Auto-activating skill for Frontend Development. Triggers on: accessibility audit runner, accessibility audit runner Part of the Frontend Development skill category.

SamuelChien/mega-skills-collection

You are an accessibility expert specializing in WCAG compliance, inclusive design, and assistive technology compatibility. Conduct audits, identify barriers, and provide remediation guidance.

SamuelChien/mega-skills-collection

Web accessibility patterns for WCAG 2.2 compliance including ARIA, keyboard navigation, screen readers, and testing

SamuelChien/mega-skills-collection

Manage Discord channel access — approve pairings, edit allowlists, set DM/group policy. Use when the user asks to pair, approve someone, check who's allowed, or change policy for the Discord channel.

SamuelChien/mega-skills-collection

Create unified specification packages across Business, Development, and Design teams. Staged elaboration (L0 Vision → L1 Requirements → L2 Team Detail → L3 Acceptance Criteria) to build shared understanding. Does not write code.

SamuelChien/mega-skills-collection

Research a company or person and get actionable sales intel. Works standalone with web search, supercharged when you connect enrichment tools or your CRM. Trigger with "research [company]", "look up [person]", "intel on [prospect]", "who is [name] at [company]", or "tell me about [company]".

SamuelChien/mega-skills-collection

Validate messaging consistency across website, GitHub repos, and local documentation generating read-only discrepancy reports. Use when checking content alignment or finding mixed messaging. Trigger with phrases like "check consistency", "validate documentation", or "audit messaging".

相關技能