技能包

security-audit:让编码代理按六阶段做安全审计

适合在已有支持工具调用与并行子代理的编码代理、并准备对自有代码做安全审计时使用,前提是先安装 skill、指定输出目录,且只保留可利用的发现。

官方来源 · security-audit

安装

npx skills add https://github.com/cloudflare/security-audit-skill --skill security-audit

适合谁

当你希望当前编码代理按安全审计员来工作,并走完六个阶段——侦察、狩猎、校验、报告、结构化输出、独立核验——以找出有真实影响、可被利用的漏洞时,使用 security-audit。它编排多个并行子代理,而不是让你手工点一份未点名的扫描产品。

前置:编码代理所用模型要支持工具调用和并行子代理;第五阶段的 schema 校验还需要 Node.js,对应 validate-findings.cjs。资料没有给出代理产品名单,列出的是能力要求,不要理解成某一家软件独占。官方说明页是

https://github.com/cloudflare/security-audit-skill

3 分钟完成第一次尝试

官方安装命令就在摘录里:

npx skills add https://github.com/cloudflare/security-audit-skill  --skill security-audit

这条命令会写入 skill,属于有副作用的步骤。先确认当前环境就是你要用来做审计的编码代理,再执行。安装后先检查本机有 Node.js,因为第五阶段要用它跑 validate-findings.cjs。

不要马上对未知仓库说「pen-test the code」。请求匹配 security audit、find vulnerabilities、pen-test the code 等触发语时会自动激活,若你不指定输出目录,它会询问,并默认写到 ~/security-audit-skill/<repo-name>/run-<N>。这会在家目录下创建文件。

低风险第一次:安装成功后,先指定一个空的、你拥有的输出目录,只问「若现在审计,输出会写到哪里」,不要授权它开始改代码或对外发包。成功信号:skill 已装上,代理能复述默认输出路径规则,并且在你确认目录之前没有开始六阶段。真要跑完整审计时,先确认目标仓库和输出路径,再使用触发语。

使用案例

案例一:在你拥有的代码仓库上启动一次审计。先完成官方安装,确认 Node.js 可用,再给出明确的输出目录,然后使用资料中的触发语之一。完成标准是代理进入六个阶段,并在指定目录留下这次 run 的输出。不要用默认路径覆盖你不打算保留的旧结果。摘录没有写出每一阶段的内部命令,因此不要编造侦察或狩猎的具体脚本。

案例二:只保留能利用的发现。资料要求:只报告你能利用的问题,每条发现都要有具体攻击场景,而不是「攻击者理论上可以……」。第五阶段用 validate-findings.cjs 做 schema 校验。这是对输出的约束:先跑校验,再决定哪些条目留下。摘要还提到对抗校验要由不同于发现者的代理来做,但摘录没有写出切换代理的命令,因此本案例完成标准是「条目带具体场景且通过 schema」,而不是已经自动换了一个核验代理。

使用边界

六个阶段是侦察、狩猎、校验、报告、结构化输出、独立核验。默认输出在 ~/security-audit-skill/<repo-name>/run-<N>。没有 Node.js 就完不成第五阶段校验。没有工具调用和并行子代理,就达不到资料写的运行要求。

不要报告无法利用的理论问题。不要对未授权的目标使用 pen-test 触发语。资料没有给出客户端名单,也没有写如何在缺 Node.js 时跳过校验。超出这些已写明的安装、触发、输出目录和报告标准,这份说明覆盖不到。