Community程式設計與開發github.com

twentyTwo/skill-hub

審查 diff、分支或拉取請求中的錯誤、有風險的變更以及可讀性問題,並按嚴重性報告發現結果。當被要求審查程式碼、檢查 PR 或在合併前檢視變更時使用。

skill-hub 是什麼?

這項技能專為 AI 代理(如 Claude Code)設計,用於自動化程式碼審查流程。它能分析 diff、分支、拉取請求或未提交的工作樹,並根據嚴重性排序報告錯誤、風險變更和可讀性問題。該技能支援多種查閱來源,包括未提交變更、分支之間的比較或特定 PR。使用時,它會先透過閱讀 PR 描述、提交訊息和關聯議題來理解意圖,然後讀取完整的 diff 及相關的周邊程式碼,最後按順序檢查正確性、行為變更、安全性、測試和可讀性。報告時會以單行結論開頭,並將發現結果分為「必須修復」、「建議」和「問題」。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/twentyTwo/skill-hub/tree/HEAD/vscode-extension/builtin-skills/code-review

Installed? Explore more 程式設計與開發 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜歡的 AI 中提問

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

說明文件

程式碼審查

審查使用者指出的變更(diff、分支、PR 或未提交的工作樹)。如果使用者未指定,則審查未提交的變更,然後是相對於其基礎分支的當前分支。

如何審查

  1. 先理解意圖。 閱讀 PR 描述、提交訊息和關聯的議題。只有在相對於其試圖達成的目標時,變更才可能出錯。
  2. 閱讀完整 diff,然後是周邊程式碼。 開啟已變更的函式及其呼叫者。大多數真正的錯誤存在於新程式碼和現有程式碼之間的邊界。
  3. 按此順序檢查:
    • 正確性:邏輯錯誤、差一錯誤、錯誤條件、未處理的 null/空值/錯誤情況、競爭條件、資源洩漏、中斷的錯誤傳遞。
    • 行為變更:未附帶遷移腳本或說明的公用 API、檔案格式、預設值或資料庫架構變更。
    • 安全性:未受信任的輸入到達查詢、shell、檔案路徑、HTML 或反序列化器;程式碼或日誌中的機密;遺失的授權檢查。
    • 測試:如果還原變更,測試是否會失敗?是否涵蓋了邊界情況?
    • 可讀性:誤導的名稱、做兩件事的函式、與程式碼矛盾的註解、無用程式碼。
  4. 在報告前驗證。 對於每個懷疑的錯誤,追蹤一個能觸發它的具體輸入。丟棄任何無法具體化的內容,或將其標記為問題。

如何報告

  • 以一行結論開頭:準備好合併、修復後合併,或需要重做。
  • 先列出最嚴重的發現。對於每個發現:file:line、出了什麼問題、具體的失敗情境,以及建議的修復方式。
  • 將必須修復與建議和問題分開。
  • 不要為了格式化工具或 linter 會捕捉的風格問題而填充審查內容,也不要複述 diff 做了什麼。
  • 如果值得注意,請說出優點(例如清晰的測試、謹慎的遷移)。保持在一行內。

Individual skills in this repo

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

相關技能