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。
