Cloudflare security-audit-skill:コーディングエージェントをセキュリティ監査者にする
Cloudflare 公式の security-audit-skill は、隔離されたハンター、敵対的検証、機械可読な所見で6段階のセキュリティ監査を回します。逐語の導入手順、3つの判定、必要な 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 にリンクし、このスキルがそのハーネスの出発点だと説明しています。
2026-11-17 時点の GitHub API スナップショットでは 74,073 stars、4,962 forks、作成 2026-06-18、最終 push 2026-09-14。その日に読んだ README どおりに導入しても、手元に入る版は異なる可能性があります。2026年6月から9月の間に更新されているリポジトリです。
「モデルにバグを探させる」との分かれ目は README の設計原則に書かれています。所見を検証するエージェントは、それを見つけたエージェントとは必ず別人です。
6つの段階
各段階がファイルを残すので、結論はセッションを越えて残ります。
| 段階 | 内容 | 出力 |
|---|---|---|
| 1. 偵察 | アーキテクチャ、信頼境界、入力面、既存の証拠、決定論的カバレッジを整理 | architecture.md、coverage-ledger.json |
| 2. カバレッジ主導のハンティング | レジャー単位で隔離ハンターを割り当て、検査内容を記録し、カバレッジ批評で穴を探す | レジャーを更新 |
| 3. 候補の検証 | 重複排除した各候補を新しい検証者に渡し、反証を試みる | — |
| 4. 構造化出力 | 判定を書き、スキーマで検証 | findings.json |
| 5. 独立した記録検証 | 新しいエージェントが最終的なソース上の主張を検証。重要な差し替えは別の検証者へ | findings.json を更新 |
| 6. 対象非依存のレポート | 検証済み記録とカバレッジレジャーからレポートを導出 | REPORT.md、FINDINGS-DETAIL.md、NEEDS-VALIDATION.md |
2つの検証スクリプトはワークフローの一部で、任意の lint ではありません。README によれば、親はレジャー作成後と以降の各更新後に validate-coverage-ledger.cjs を、第4段階と第5段階の各差し替え後に validate-findings.cjs を実行します。どちらも「zero-dependency」で、前提条件に Node.js しか挙がっていない理由でもあります。
3つの判定
この区別自体が価値です。セキュリティ作業が実際に詰まる場所に対応しています。
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
エージェント選択と非対話オプションは 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> です。バージョン管理で無視されるディレクトリを明示的に選んだときにだけ、対象リポジトリ内に書き込みます。大事なリポジトリでは覚えておく価値があります。
必要なもの
- ツール利用と並列サブエージェントに対応したモデルのコーディングエージェント。段階ごとに隔離ハンターと新しい検証者を起動します。
- Node.js。2つの検証スクリプト用です。
- 対象が制御するもの(ビルド、テスト、プロセス、ブラウザ、エミュレータ、ファザー、フィクスチャ)に対する OS レベルサンドボックス。README の基準は具体的です。外部ネットワークを無効化し、許可リスト化された環境を使い、リソース制限を掛け、書き込みは割り当てられたスクラッチパスだけに限定します。
3つ目が最も飛ばされがちです。これがないとワークフローは設計どおりに縮退し、対象コードを実行せずリードを 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 で回すときの実務的な注意が2つあります。
- 並列の予算を取る。 各段階は隔離サブエージェントを求めます。実行方法とトークン消費はサブエージェントガイドにあります。
- 既定の出力先を維持する。 レポートをリポジトリの外(
~/security-audit-skill/...)に置けば、監査が diff を汚したり、所見がコミットに混ざったりしません。所見はプルリクエストと同じようにレビューしてください。コードレビューの習慣が適しています。
リポジトリには validate-findings.test.cjs と validate-coverage-ledger.test.cjs も含まれており、検証スクリプト自体がテストされています。機械可読な出力に本気で取り組んでいる小さな証拠です。
これは何ではないか
- ペネトレーションテストやバグバウンティの代替ではありません。 レビュー可能な記録を生むエージェントワークフローです。本番で悪用可能かどうかは、モデルから見えないデプロイ文脈に依存します。
- 1回で完了する保証はありません。 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 を追加します。
1回の実行で何が出ますか?
findings.json(confirmed / needs_validation / rejected、report-schema.json で検証)と、REPORT.md、FINDINGS-DETAIL.md、NEEDS-VALIDATION.md。すべて architecture.md と coverage-ledger.json から導出されます。
サンドボックスは必須ですか?
対象が制御するものすべてに必要です。外部ネットワーク無効、許可リスト環境、リソース制限、書き込みはスクラッチパスのみ。なければリードを needs_validation に留め、対象コードを実行しません。
DeepSeek Harness から実行できますか?
できます。security-audit スキルのフォルダを .dsh/skills/ にコピーします。ツール利用と並列サブエージェント、そして検証用に Node.js が必要です。
出典
以上の内容は 2026-11-17 に読んだ次のページに基づきます。
- github.com/cloudflare/security-audit-skill — README: リポジトリの要約、6段階とその出力ファイル、3つの判定と定義、2つのゼロ依存バリデータと実行タイミング、導入コマンドと
--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 がリンクする、このスキルの元になったハーネスの解説記事。
- skills.sh — README が示す Skills CLI。
このスキルは Cloudflare のオープンソースプロジェクトです。DeepSeek の製品ではなく、当サイトとも関係ありません。コマンドは上記の日付時点の README に基づきます。2026年6月から9月の間に更新されているため、実行前に再確認してください。
