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 插件,绝不滥发。