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 上跑的兩個實際提醒:
- 給平行留預算。 這些階段要隔離的子 agent,怎麼跑、燒多少 token 見子 agent 指南。
- 保留預設輸出目錄。 把報告放在倉庫外(
~/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 為 Organizationcloudflare、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。
