cloudflare/security-audit-skill

security-audit 是一個給 coding agent 用的 skill,把 agent 變成安全稽核員,透過六個階段跑完整稽核流程。它會先做偵察並建立覆蓋帳本,再派隔離的 hunter 找候選問題,交給全新的 verifier 試圖否證,最後輸出可驗證的結構化紀錄與報告。與一般掃描工具不同,它強調驗證者與發現者分離,並用 validate-findings.cjs 與 validate-coverage-ledger.cjs 檢查輸出格式。
AI 寫程式與 SkillsJavaScript★ 51,213

專案簡介

以上內容由 AI 根據官方 README 整理,未經實測;指令以官方文件為準。

原始描述

A coding-agent skill for multi-phase security audits with independently verified, machine-readable findings

AI 規格

費用需自備支援 tool use 與平行 sub-agents 的 coding agent 模型

主要功能

  • 六階段流程:偵察、覆蓋導向狩獵、候選驗證、結構化輸出、獨立紀錄驗證、報告
  • 產出 architecture.md 與 coverage-ledger.json 追蹤覆蓋範圍
  • findings.json 依 report-schema.json 驗證,分 confirmed、needs_validation、rejected
  • 驗證者永遠不是發現問題的 agent,採對抗式驗證
  • 內建多種攻擊類別提示檔,涵蓋 LLM、Web、客戶端、供應鏈、雲端等
  • 多次執行累加,用先前 ledger 與 findings 找出未覆蓋缺口

系統需求

  • 支援 tool use 與平行 sub-agents 的 coding agent 模型
  • Node.js(執行零依賴的 findings 與 coverage-ledger 驗證器)
  • 由作業系統強制執行的 sandbox:關閉外部網路、消毒允許清單環境、限制資源、只允許寫入指定暫存路徑

安裝方式

  1. 用 Skills CLI 安裝 security-audit skill

    npx skills add https://github.com/cloudflare/security-audit-skill \
      --skill security-audit
  2. 以使用者層級全域安裝 skill

    npx skills add https://github.com/cloudflare/security-audit-skill \
      --skill security-audit \
      --global

快速開始

security audit this codebase

設定教學

安裝 skill 後,在要稽核的程式庫中啟動支援 tool use 與平行 sub-agents 的 coding agent,直接以自然語言要求安全稽核即可。未指定輸出目錄時,預設寫到 ~/security-audit-skill/<repo-name>/run-<N>。

主要設定檔

設定內容整理自 repository 內的設定檔與文件,未經實測;變數名稱與指令以官方檔案為準。

適合用途

  • 想讓 coding agent 對整個程式庫做結構化安全稽核的開發者
  • 需要可機器讀取、可驗證 findings 紀錄的安全團隊
  • 要對 LLM、Web、客戶端、供應鏈或雲端等不同目標套用對應攻擊類別提示的人
  • 想用多次累加執行逐步補齊覆蓋缺口的稽核人員

常見問題

skill 什麼時候會自動啟用?

skill 會在請求符合觸發條件時自動啟用,例如 security audit、find vulnerabilities、pen-test the code 等。直接要求稽核或滲透測試會走完整稽核模式。

稽核結果預設存在哪裡?

預設會寫到 ~/security-audit-skill/<repo-name>/run-<N>。只有在明確指定版本控制忽略的目錄時,才會寫入目標程式庫內。

需要安裝 Node.js 嗎?

需要 Node.js 來執行 validate-findings.cjs 與 validate-coverage-ledger.cjs 這兩個零依賴驗證器。

執行目標程式碼的建置與測試需要什麼環境?

需要一個由作業系統強制執行的 sandbox,且要關閉外部網路、使用消毒過的允許清單環境、限制資源,並只允許寫入指定的暫存路徑。缺少這些控制時,工作流程會把 lead 保持為 needs_validation,而不執行目標程式碼。

可以對同一個程式庫重複執行嗎?

可以。同一程式庫的多次執行是累加的,skill 會用先前的 ledger 與 findings 找出缺口、重新驗證變更的原始碼,並延續目前原始碼的證據。

confirmed、needs_validation、rejected 有什麼差別?

confirmed 有完整的來源追蹤與有界的觀察結果;needs_validation 有一個明確未解決的事實且不給嚴重度;rejected 則記錄被否證的候選。

公開標籤

未提供
Stars 等欄位只是 GitHub 快照,不保證品質、安全性或商用適用性。