Superpowers 是一套給 coding agent 用的軟體開發方法論,由一組可組合的 skills 加上開場指令組成,讓 agent 在對話一開始就自動套用。它把流程固定成先問清需求、寫設計、拆計畫、再進 TDD 實作與程式碼審查,而不是一看到需求就直接寫程式。與單純的規則檔不同,這些 skills 會依情境自動觸發,並支援 Claude Code、Codex、Cursor、Gemini CLI、OpenCode 等多個 harness。
cloudflare/security-audit-skill
專案簡介
以上內容由 AI 根據官方 README 整理,未經實測;指令以官方文件為準。
原始描述
A coding-agent skill for multi-phase security audits with independently verified, machine-readable findings
AI 規格
主要功能
- 六階段流程:偵察、覆蓋導向狩獵、候選驗證、結構化輸出、獨立紀錄驗證、報告
- 產出 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:關閉外部網路、消毒允許清單環境、限制資源、只允許寫入指定暫存路徑
安裝方式
用 Skills CLI 安裝 security-audit skill
npx skills add https://github.com/cloudflare/security-audit-skill \ --skill security-audit以使用者層級全域安裝 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>。
主要設定檔
skills/security-audit/SKILL.md— 設定、核心原則、平台術語與工作流程總覽skills/security-audit/report-schema.json— 定義 findings.json 三種 verdict 的 JSON schemaskills/security-audit/ATTACK-CLASSES.md— 核心、wildcard 與 obvious-things 的攻擊提示skills/security-audit/VALIDATION-AND-REPORTING.md— Phase 3 到 6 的驗證、結構化輸出與報告流程
設定內容整理自 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 則記錄被否證的候選。