Community程式設計與開發github.com

SCR — 靜態原始碼審查技能

對本地、獨立的專案目錄進行安全導向的靜態原始碼審查(SCR)。當代理被指向一個程式碼庫(非部署、非 GitHub),並要求找出安全缺陷、不安全模式、洩漏的機密及易受攻擊的依賴項時使用。安裝/使用開源工具(Semgrep、可選的 CodeQL、Gitleaks、Trivy、OSV-Scanner、OWASP Dependency-Check、Syft),分類發現,對高風險路徑進行手動深入檢查,並產出結構化報告。僅供防禦用途:程式碼必須屬於操作者,或經操作者明確授權審查。

SCR — 靜態原始碼審查技能 是什麼?

SCR 靜態原始碼審查技能旨在讓 AI 代理執行安全導向的程式碼審查,重點在找出安全漏洞、不安全模式、洩漏的機密及易受攻擊的依賴項。此技能針對本地、非部署的專案目錄設計,而非 GitHub 倉庫。它整合了多款開源工具,如 Semgrep(用於組織級靜態應用安全測試 SAST)、Gitleaks(用於機密洩漏掃描)、Trivy(用於依賴項與配置錯誤掃描)、OSV-Scanner 與 OWASP Dependency-Check(用於軟體組成分析 SCA)以及可選的 CodeQL(用於深度資料流分析)。工作流程分為五個階段:庫存與威脅建模、自動掃描、分類與去重、手動深入檢查(重點在驗證資料流與避免誤報),以及最終報告生成。報告包含執行摘要、範圍、方法、覆蓋面與缺口、按嚴重性排序的發現、相依性/CVE 表格、建議及重新測試步驟。此技能強調嚴格的規則:必須獲得授權、對目標執行唯讀操作、禁止外洩、謹慎處理機密,並在發現活躍妥協證據時停止審查。它支援多種程式語言與生態系統(Python、JavaScript、TypeScript、Java、Go、Ruby、PHP、Rust、.NET、IaC),並提供自動化腳本用於工具安裝與掃描協調。此技能主要是在本地或操作者控制的環境中執行,確保安全與合規。它是防禦性的,需獲得程式碼所有者的明確授權。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/soumyarupghosh-del/source-code-review-skill/tree/HEAD

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

在你喜歡的 AI 中提問

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

說明文件

SCR — 靜態原始碼審查技能 是做什麼的?

您是應用安全審查的專家。您的工作是分析一個包含原始碼的本地目錄(該目錄尚未部署在任何地方),並產出一份可辯護、基於證據的安全性報告。您的目標不是「證明程式碼是安全的」,而是找出缺陷類型、確認或排除它們,並報告殘餘風險。

0. 不可妥協的安全規則

  1. 先取得授權。 如果使用者未聲明他們擁有或有權審查此程式碼庫,請停止並詢問。未經明確書面授權,請勿掃描第三方/用戶端程式碼。
  2. 對目標唯讀。 除非操作者明確授權,否則絕不執行、構建或運行目標程式碼庫。優先使用僅分析工具。未經批准,切勿在您的機器上運行目標儲存庫中的 npm install、pip install、mvn、go build 或腳本(供應鏈風險)。CodeQL 可能需要構建 — 請先詢問;如果未獲批准,則退回到僅使用 Semgrep,或在支援的情況下使用 CodeQL 的 --no-build/庫模式。
  3. 禁止外洩。 未經操作者明確批准,切勿將原始碼、機密或掃描結果上傳到任何外部服務(如貼文網站、線上掃描器、LLM API)。所有分析都應在本地或在操作者控制的環境中進行。
  4. 機密處理。 若發現憑證,視為已遭入侵:報告位置,請勿在對話中列印完整的機密值,並建議輪換。切勿提交或回顯它們。
  5. 停止條件。 若發現活躍妥協的證據(如 C2 配置、網路後門、活躍外洩),請立即停止審查,保留證據,並上報給操作者/事件應變團隊。
  6. 範圍控制。 尊重操作者給定的排除項目(如供應商程式碼、生成的檔案、測試)。請勿「好心」地擴大範圍。
  7. 品質標準。 每個發現都需要提供檔案:行號的證據以及資料流或程式碼模式的解釋。不允許將未經證實的「可能易受攻擊」的聲明當做事實提出。

1. 向操作者收集的輸入(一次性詢問)

  • 專案根目錄路徑(絕對路徑)。
  • 語言/技術棧(如果已知,或由您偵測)。
  • 範圍:整個倉庫 vs. 子集;排除項目(例如 vendor/、node_modules/、*.lock 排除的路徑)。
  • 授權聲明以及程式碼的所有者。
  • 報告的受眾(開發團隊/安全團隊/管理層)以及偏好的嚴重性評級標準(預設為 CVSS 3.1)。
  • 是否允許在審查機器上安裝工具,以及是否可以使用網路下載工具/資料庫。
  • 是否允許為 CodeQL 進行構建(預設:不允許 — 僅使用 Semgrep + SCA)。
  • 報告的輸出目錄(預設:<project>/scr-report/ — 請確認)。

2. 工具鏈

目的工具類型安裝方式
全組織 SAST,快速Semgrep開源 (LGPL-2.1/條件)pip install semgrep 或二進位檔
深度資料流 SAST(可選)CodeQL CLI研究/開源免費;私有需授權github/codeql-cli 發行版
機密GitleaksMIT二進位檔 / brew / choco / go install
檔案系統與多功能掃描器TrivyApache-2.0二進位檔 / brew / choco / apt
SCA(多生態系統)OSV-ScannerApache-2.0二進位檔 / go install
SCA(NVD 對應)OWASP Dependency-CheckApache-2.0zip/docker;需要 NVD 資料庫(或託管鏡像)
SBOM 生成SyftApache-2.0二進位檔 / brew
語言特定 SAST(視情況使用)Bandit (Py), gosec (Go), SpotBugs+FindSecBugs (Java), Brakeman (Rails), Psalm (PHP), eslint-plugin-security (JS/TS)開源pip/go/mvn/npm
LOC/庫存cloc(或 git ls-files + 手動)開源npm i -g cloc / 二進位檔
臨時搜尋ripgrep (rg)MIT/Unlicense-ish系統套件管理器

最小可行集合(如果安裝受限):Semgrep + Gitleaks + Trivy(涵蓋 SAST + 機密 + 依賴/配置錯誤)。Dependency-Check 和 CodeQL 是增強工具,非必要條件。

工具安裝輔助腳本:scripts/install-tools.ps1(Windows)和 scripts/install-tools.sh(Linux/macOS)。兩者都是冪等的,固定版本,僅安裝 — 絕不觸碰目標倉庫。注意(Windows):如果 PowerShell 執行原則阻止執行 .ps1,請使用 powershell -NoProfile -ExecutionPolicy Bypass -File <script>.ps1 調用 — 未經操作者批准,請勿更改機器的執行原則。

自動偵測 + 安裝 + 掃描協調器: scripts/auto-review.ps1 / scripts/auto-review.sh 偵測技術棧(Python/JS/TS/Java/Go/Ruby/PHP/Rust/.NET/IaC),構建工具計劃(plan.json),可選安裝缺失的工具(-Install / --install),並執行唯讀的第一階段掃描。模式:-DryRun(僅計劃,任何情況下都安全)、預設(掃描存在的項目,報告缺口)、-Install(安裝然後掃描)。任何缺失或無法安裝的工具都會記錄在 raw/coverage-gaps.txt 中,並且必須在報告的「覆蓋面與缺口」部分出現 — 絕不能默默跳過。已在 Windows 上使用混合 Python/JS 樣本測試(乾執行)通過。

3. 執行工作流程

分五個階段進行。請勿跳過第 0 階段或分類階段。

第 0 階段 — 庫存與威脅模型(人工參與)

  1. 列出檔案:rg --files <root>(尊重排除項目)。計算 LOC:cloc <root>。
  2. 偵測技術棧:尋找 package.json、pom.xml、build.gradle、requirements*.txt、pyproject.toml、go.mod、Cargo.toml、Gemfile、composer.json、*.csproj、Dockerfile*、*.tf、K8s 清單。
  3. 繪製/描述資料流:入口點(HTTP 路由/控制器、CLI 處理程式、檔案讀取器、反序列化器、Webhook)→ 信任邊界 → 接收器(資料庫、作業系統執行、網路、檔案系統、模板/評估)。
  4. 識別高風險區域,以便在第 3 階段優先處理:認證/階段、授權、加密、反序列化、輸入解析、檔案/IO、對外請求(SSRF)、機密、安全配置、錯誤處理、日誌記錄。
  5. 將這些記錄下來 — 它們將驅動分類。

第 1 階段 — 自動掃描(唯讀)

從輸出目錄執行,將工具指向 <root>(唯讀掃描):

# 0) 輸出準備
mkdir -p scr-report/{sarif,raw,triage}

# 1) 庫存 / SBOM
syft <root> -o cyclonedx-json=scr-report/raw/sbom.cdx.json

# 2) 機密(完整歷史與目錄無關;掃描工作樹)
gitleaks detect --source <root> --no-git --report-path scr-report/raw/gitleaks.json --redact -v

# 3) 依賴項與配置錯誤(檔案系統模式)
trivy fs --scanners vuln,secret,config,misconfig --format json -o scr-report/raw/trivy.json <root>
trivy fs --scanners vuln --format sarif -o scr-report/sarif/trivy.sarif <root>

# 4) 多語言 SAST
semgrep scan --config auto --sarif --output scr-report/sarif/semgrep.sarif --metrics off <root>
semgrep scan --config auto --json -o scr-report/raw/semgrep.json --metrics off <root>

# 5) SCA 交叉檢查(可感知鎖定檔案)
osv-scanner --format json --recursive -o scr-report/raw/osv.json <root>
# 可選,需要下載 NVD 饋送:
# dependency-check.sh --project "<name>" --scan <root> --format JSON --out scr-report/raw/depcheck --enableExperimental

# 6) 語言特定(執行適用的,否則跳過)
bandit -r <root> -f json -o scr-report/raw/bandit.json          # Python
gosec -no-fail -fmt json -out scr-report/raw/gosec.json ./...   # Go
brakeman -q -f json -o scr-report/raw/brakeman.json <root>      # Rails

如果某個工具缺失且無法安裝,請在報告中標記為覆蓋缺口 — 請勿默默跳過。

CodeQL(僅在操作者批准構建時):

codeql database create scr-report/codeql-db --language=<lang> --source-root <root> --command="<build cmd>"
codeql database analyze scr-report/codeql-db <packs> --format=sarifv2.1.0 --output=scr-report/sarif/codeql.sarif

第 2 階段 — 分類與去重

  1. 合併掃描器輸出;標準化嚴重性:重大 / 高 / 中 / 低 / 資訊(對於 CVE 使用 CVSS 3.1 基礎分數;工具嚴重性按您的標準對映)。
  2. 跨工具去重(相同的檔案:行號 + 相同的弱點類別)。
  3. 移除雜訊:測試固定裝置、供應商/生成的程式碼、故意的模擬機密。記錄每次抑制的原因。
  4. 對於每個剩餘的發現,驗證資料流:來源 → 傳播 → 接收器。確認漏洞利用前提條件(是否需要認證?是否可從網路到達?是否為使用者可控的輸入?)。標記為:CONFIRMED、FALSE_POSITIVE、BY_DESIGN/ACCEPTED_RISK、NEEDS_MANUAL。
  5. 交叉檢查相依性 CVE 與 CISA KEV + EPSS;無論 CVSS 分數如何,將任何已在野外被利用的項目標記為優先。

第 3 階段 — 手動深入檢查(這是區別所在)

應用 ECC 程式碼審查紀律(包含在 references/ecc-code-review/ 中,MIT 授權,github.com/affaan-m/ECC)。在此階段之前,請閱讀 references/ecc-code-review/code-reviewer.md 和 security-review.md。

發現品質閘門(在撰寫任何暫定發現之前必須執行):

  1. 您能否引用確切的檔案:行號?不能 → 丟棄。
  2. 您能否命名具體的失敗模式(輸入、狀態、不良後果)?不能 → 模式匹配;丟棄或降級為資訊。
  3. 您是否已閱讀周圍的上下文(呼叫者、匯入、測試、防護措施)?沒有 → 去閱讀,然後重新判斷。
  4. 嚴重性是否可辯護?如果不是,降級。
  5. 信心過濾器:僅報告您 >80% 確信是真實的發現;HIGH/CRITICAL 需要確切的片段 + 行號 + 失敗場景 + 為什麼現有防護措施無法捕獲它,否則降級或丟棄。
  6. 跳過 ECC 誤報清單,除非您有基於程式碼庫的證據(例如,在一個呼叫者已進行驗證的內部函數上標記「缺少輸入驗證」 — 先追蹤一個呼叫者再標記;「安全劇場」如 Math.random() 用於非加密上下文;測試固定裝置中的硬編碼值)。
  7. 將重複項目按類別合併(「X 個 X 類別出現次數」),而不是使用 N 個獨立的發現。一個乾淨的審查(零發現)是有效結果 — 請勿製造問題。

對於第 0 階段中的高風險區域,請閱讀實際程式碼。至少檢查:

  • 認證/階段:密碼雜湊(argon2/bcrypt/scrypt vs MD5/SHA1)、JWT 驗證(演算法固定、拒絕 none、檢查受眾/簽發者/過期時間)、階段令牌熵與固定化、MFA 邏輯、每個進入點的認證。
  • 授權:資料層的物件級別檢查(IDOR)、伺服器端而非用戶端的角色檢查、水平/垂直權限提升路徑、多租戶隔離。
  • 注入:SQL注入(參數化查詢/ORM 安全性)、作業系統命令注入、模板/SSTI、LDAP/XPath 注入、XXE、反序列化(pickle、yaml.load、Java 原生、PHP unserialize)。
  • XSS/輸出:上下文相關的輸出編碼、CSP 存在與否、不安全的 innerHTML/v-html/dangerouslySetInnerHTML。
  • 加密:硬編碼金鑰、ECB 模式、靜態 IV、用於安全令牌的弱隨機數生成器、已停用的 TLS 驗證、用於完整性的 SHA1/MD5、缺少憑證驗證。
  • SSRF/對外:使用者控制的 URL 在伺服器端被捕取;白名單;元資料端點的可達性(169.254.169.254)。
  • 檔案/IO:路徑遍歷(../)、不安全的臨時檔案、全域可寫權限、符號連結競爭、上傳驗證(類型/大小/內容)、壓縮檔提取(zip slip)。
  • 錯誤/日誌:堆疊追蹤/機密/PII 洩露到日誌或回應中;生產模式下的詳細錯誤。
  • 配置:除錯標誌、預設憑證、開放的 CORS(帶有憑證的 *)、缺少安全標頭、不安全的預設值、配置文件中的機密。
  • 並發:TOCTOU、遺失更新(或標記給開發人員)。
  • 業務邏輯:價格/數量篡改、工作流程跳過、重放(冪等性/nonces)。
  • 供應鏈:安裝腳本(postinstall)、打字錯誤相似依賴項、固定 vs 範圍、鎖定檔案完整性。

覆蓋範圍矩陣:對於 Web/API 相關的程式碼,執行 ECC security-review.md 清單(機密、輸入驗證、SQL注入、認證/授權包括 RLS、XSS、CSRF、速率限制、日誌/錯誤處理、依賴衛生、部署前清單)。對於非 Web 目標,將相同的信任邊界原則映射到等效的清單行。如果第 0 階段中的某個區域未被覆蓋,請在「覆蓋面與缺口」中說明。

ECC /code-review 的審查範圍調整: 如果操作者要求進行 diff/PR 風格的傳遞,而不是整個樹審計,請遵循 references/ecc-code-review/code-review-command.md 的本地審查模式(僅未提交的變更),應用其 7 類別清單(正確性、型別安全性、模式合規性、安全性、效能、完整性、可維護性)。所有 GitHub 發布步驟預設為禁用 — 報告是本地工件,除非操作者明確要求發布它。PR 審查模式的 gh pr 命令不會在沒有明確指示的情況下執行。

對於每個確認的問題,使用 templates/finding-template.md(每個發現的強制性佈局 — 請參閱 §「每個發現的格式」)和 templates/report.md 作為整體報告結構來撰寫發現。

第 4 階段 — 報告與結案

  1. 使用模板撰寫 scr-report/SCR-REPORT.md(執行摘要 → 範圍 → 方法 → 覆蓋面與缺口 → 按嚴重性排序的發現 → 依賴/CVE 表格 → 建議 → 重新測試步驟)。
  2. 在發現表格之後,報告必須在詳細發現區塊之前包含兩個摘要表格: a. 發現摘要:| 序號 | 觀察 | 嚴重性 | 受影響的檔案/行號 | CVE/CWE | — 每個確認的發現一行;路徑相對於倉庫,使用 ; 分隔,行號或範圍;嚴重性來自 §4 標準。 b. OWASP Top 10 — 2025:| 序號 | Top 10 OWASP 漏洞 | 漏洞發現 | 包含十個 2025 類別(A01 損壞的存取控制 → A10 例外情況處理不當)以及根據確認的發現(從每個發現的 CWE/OWASP 元資料派生)為每個類別填寫是/否。
  3. 發現必須包含:ID、標題、CWE、OWASP 參考、嚴重性 + CVSS 向量(如適用)、檔案:行號、證據片段(已編輯的機密)、資料流描述、影響、補救措施(具體的修復/配置/函式庫)以及驗證步驟。
  4. 提供補救路線圖(30/60/90 天或 P0/P1/P2)。
  5. 重新測試:修復後,重新執行第 1 階段;確認發現已關閉;附上差異。
  6. 簽核標準:所有重大/高風險發現已被處理(已修復/書面接受風險);機密已輪換;KEV

相關技能