Cloudflare security-audit-skill:把編碼代理變成安全稽核員

Cloudflare 官方的 security-audit-skill 用隔離的 hunter、對抗式複核與機器可讀的結論跑六階段安全稽核。附逐字安裝指令、三種判決、它要求的 OS 級沙箱,以及怎麼和 DeepSeek Harness 一起用。

最近更新: 2026-11-17

先說結論

security-audit 是 Cloudflare 自己維護的編碼代理技能,用來跑一套結構化的安全稽核——不是對著 URL 掃的掃描器。倉庫簡介是:「A coding-agent skill for multi-phase security audits with independently verified, machine-readable findings.」它是官方專案:倉庫在 GitHub 的 cloudflare 組織下,MIT 授權,README 連到 Cloudflare 工程部落格的 Build your own vulnerability harness,並說明這個技能就是那套 harness 的起點。

依 GitHub API 在 2026-11-17 的快照:74,073 stars、4,962 forks,建立於 2026-06-18,最後一次 push 是 2026-09-14。照那天讀的 README 操作,你裝到的版本可能已不同——它在 2026 年 6 月到 9 月之間動過。

它和「讓模型自己找 bug」的分水嶺,寫在 README 的設計原則裡:查證的人永遠不是發現的人。

六個階段

每個階段都落盤可查,所以結論能活過一個工作階段。

階段做什麼產出
1. 偵察畫出架構、信任邊界、輸入面、既有證據與確定性覆蓋architecture.md、coverage-ledger.json
2. 覆蓋驅動的搜捕依 ledger 單元派隔離的 hunter,記錄檢查內容,用 coverage critic 找缺口就地更新 ledger
3. 候選驗證每個去重後的候選交給全新的 verifier 去證偽—
4. 結構化輸出寫判決並依 schema 驗證findings.json
5. 獨立複核新 agent 複核最終原始碼論斷;重大替換再走一次獨立 verifier更新 findings.json
6. 與目標無關的報告從已驗證記錄與覆蓋 ledger 衍生報告REPORT.md、FINDINGS-DETAIL.md、NEEDS-VALIDATION.md

兩個驗證腳本是流程的一部分,不是可選 lint。README 寫明:父 agent 在建立 ledger 之後、以及之後每次更新後跑 validate-coverage-ledger.cjs;在第 4 階段以及每次第 5 階段替換之後再跑 validate-findings.cjs。兩者都是「zero-dependency」,這也是為什麼前置條件裡只提 Node.js。

三種判決

區分本身才是價值所在,因為它對應安全工作的真實卡點:

  • confirmed —— 完整的原始碼鏈路,加上有界的觀測結果。
  • needs_validation —— 有一個確切的未解決事實,並且不給 severity。
  • rejected —— 被證偽的候選,記錄下來,避免有人再翻一遍。

README 的設計原則解釋了這套紀律:只有確立的邊界失守才能 confirmed;severity 需要 impact(likelihood × impact,而不是「偏離清單」);縱深防禦缺口不是漏洞——如果 A 層擋住了攻擊,缺 B 層只是一條加固建議。

安裝

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

使用者層級安裝:

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

agent 選擇與非互動參數看 README 指的 skills.sh,本機也可以 npx skills --help。

怎麼跑

在要稽核的程式碼庫裡(或指向它)啟動編碼代理,然後用自然語言提要求。README 自己的例子:

security audit this codebase
find security vulnerabilities in ./src
do a security review, output to ~/audits/my-project

請求命中觸發詞(security audit、find vulnerabilities、pen-test the code 等)時技能自動啟用。直接的全庫稽核或滲透請求走完整稽核模式;安全提問與聚焦的漏洞工作走指導模式,除非你要報告產物。

完整稽核模式下,沒指定輸出目錄就預設 ~/security-audit-skill/<repo-name>/run-<N>。只有你明確選了一個被版本控制忽略的目錄時,工作流才會寫進目標倉庫——在你在意的倉庫上,這條值得記住。

前置條件

  • 模型支援工具呼叫與平行子 agent——這些階段依賴派生隔離 hunter 和全新 verifier。
  • Node.js,跑兩個驗證腳本。
  • 針對任何「目標可控」的東西(建置、測試、行程、瀏覽器、模擬器、fuzzer、fixture)要有 OS 級沙箱。README 的門檻寫得很具體:禁外網、用白名單化的乾淨環境、有資源上限、只能寫指定的 scratch 路徑。

第三條最常被跳過。缺了它,工作流會依設計降級——把線索保持為 needs_validation,而不是執行目標程式碼。dsh 的沙箱與審批模型見沙箱、審批與密鑰,把這類技能指向第三方倉庫前先讀它。

和 DeepSeek Harness 一起用

這個技能是一個資料夾:SKILL.md 加上各階段文件——RECONNAISSANCE.md、HUNTING.md、VALIDATION-AND-REPORTING.md,以及依攻擊面分的 AI-AND-LLM.md、CLIENT-SIDE.md、CLOUD-AND-DEPLOYMENT.md 等。這正是 dsh 從 .dsh/skills/ 讀的對象,所以安裝就是複製:

git clone https://github.com/cloudflare/security-audit-skill
mkdir -p .dsh/skills && cp -r security-audit-skill/skills/security-audit .dsh/skills/

在 dsh 上跑的兩個實際提醒:

  1. 給平行留預算。 這些階段要隔離的子 agent,怎麼跑、燒多少 token 見子 agent 指南。
  2. 保留預設輸出目錄。 把報告放在倉庫外(~/security-audit-skill/...),稽核就不會污染 diff,也不會把發現混進 commit。審這些結論要像審 PR 一樣——程式碼評審是合適的手感。

倉庫裡還帶了 validate-findings.test.cjs 與 validate-coverage-ledger.test.cjs,說明驗證腳本本身也有測試;這是它認真對待機器可讀輸出的小訊號。

它不是什麼

  • 不是滲透測試或漏洞賞金的替代品。 它是一個產出可複核記錄的 agent 工作流。漏洞在生產環境能不能被利用,仍取決於模型看不到的部署脈絡。
  • 不是一次就夠。 README 說多次執行是疊加的,並寫明在 Cloudflare 自己的測試執行裡「a single run found roughly half of the vulnerabilities that repeated runs found in total」。這是專案對自己那幾次執行的自我陳述,不是獨立基準,也不能推到你自己的程式碼庫上。
  • 不能代替沙箱。 前置條件不是建議。先讀安全。
  • 不是跳過評審的許可。 每條判決都設計成要人複核;needs_validation 的存在,就是為了別讓未解決的事實被洗成 severity。

常見問題

cloudflare/security-audit-skill 是 Cloudflare 官方的嗎? 是。倉庫在 cloudflare 組織下,MIT 授權,README 連到 Cloudflare 工程部落格介紹它來源的那篇文章。

怎麼安裝? npx skills add https://github.com/cloudflare/security-audit-skill --skill security-audit,使用者層級加 --global。

跑一次產出什麼? findings.json(confirmed / needs_validation / rejected,依 report-schema.json 驗證),加上 REPORT.md、FINDINGS-DETAIL.md、NEEDS-VALIDATION.md,全部從 architecture.md 與 coverage-ledger.json 衍生。

一定要沙箱嗎? 任何目標可控的環節都要:禁外網、白名單環境、資源上限、只寫 scratch 路徑。缺了它就只把線索保持為 needs_validation,不執行目標程式碼。

DeepSeek Harness 裡能跑嗎? 能,把 security-audit 技能目錄複製進 .dsh/skills/。需要工具呼叫與平行子 agent,以及 Node.js 跑驗證腳本。

來源

上面每條都來自這些頁面,讀取日期 2026-11-17:

  • github.com/cloudflare/security-audit-skill —— README:倉庫簡介、六階段及其產出檔案、三種判決及其定義、兩個零依賴驗證腳本與執行時機、安裝指令與 --global 變體、用法範例、完整稽核模式與指導模式、預設輸出目錄與被版本控制忽略的條件、含 OS 級沙箱的前置條件、設計原則、「只找到約一半漏洞」的自我陳述、聯絡信箱。GitHub API 2026-11-17 快照:MIT、Owner 為 Organization cloudflare、74,073 stars、4,962 forks、建立於 2026-06-18、最後 push 2026-09-14(快照,不是固定數字)。
  • blog.cloudflare.com/build-your-own-vulnerability-harness —— README 連的、介紹這個技能所來源的那套 harness 的文章。
  • skills.sh —— README 指定的 Skills CLI。

這個技能是 Cloudflare 的開源專案;不是 DeepSeek 的產品,也與本站無關。指令取自上面那天看到的 README——這個倉庫在 2026 年 6 月到 9 月之間改過,動手前再核一遍。

相關閱讀:沙箱、審批與密鑰、用 dsh 做程式碼評審、安裝技能、子 agent。

DSH Plugins 是獨立的 DeepSeek Harness 外掛目錄,與 DeepSeek 官方無關,也不代表官方背書。第三方外掛未經安全稽核,安裝前請審查原始碼。

每週取得最新的 DeepSeek Harness 外掛,絕不濫發。