cloudflare-security-audit

用途

Cloudflare Security Audit 用于对已授权的代码库进行安全审计，目标是发现具有真实影响的可利用漏洞。它适用于用户提出执行安全审计、查找安全缺陷、进行安全审查或渗透测试代码库等请求时。该技能可针对 Web 应用、API、服务、CLI 工具、库、守护进程等进行激活。

主要能力

该技能采用六阶段工作流：

1. 侦察（Recon）：映射应用架构、信任边界和输入面，输出 architecture.md。
2. 猎取（Hunt）：依据 HUNTING.md 进行编排、方法论和验证规则，从 ATTACK-CLASSES.md 选择范围，将原生、AI/LLM、HTTP 协议/认证和客户端目标路由到专门的伴随文件。
3. 验证（Validate）：整合重复项，并独立尝试反驳每一个发现。
4. 报告（Report）：撰写 REPORT.md 和 FINDINGS-DETAIL.md。
5. 结构化输出：生成 findings.json，并使用用户环境中已有的受信任 JSON Schema 验证器进行验证。
6. 独立验证（Independent verification）：核实每一项事实性声明并对齐所有输出。

技能强调动态确认，优先构建并运行目标本地组件以复现崩溃或测试载荷。对于需要部署环境才能确认的问题，会标记为 "requires deployment testing"，不会报告为已确认。

使用方式

技能设有强制确认关卡。在运行任何会探测、利用、更改、持久化、提取数据或尝试凭证访问目标的命令之前，需：

• 要求用户说明确切的目标 URL、IP、账户或资源。
• 要求用户确认已获得书面授权和允许的范围。
• 展示确切的命令并解释其预期效果。
• 等待当前对话中的明确确认。

没有该确认时，保持只读并提供防御性指导。建议使用沙箱、一次性虚拟机或受控实验室环境。

技能在开始时建立两条路径和一个目标身份：目标（待审计代码库）和输出目录。目标身份为规范物理仓库路径加上规范化来源的 owner/repository URL，两者哈希后生成稳定目标 ID。输出目录默认为 ~/security-audit-skill/<target-id>/run-<N>。

子代理（阶段 1、2、3、6）不写文件，通过 Task 工具将结果返回给主代理，由主代理负责将所有文件写入输出目录。

适用场景

• 对 Web 应用、API、服务、CLI 工具、库、守护进程进行安全审计。
• 查找授权绕过、注入路径等可实际利用的漏洞。
• 对业务逻辑、状态机违规、链式攻击和隐式信任假设进行手动审计。

如果存在同一目标 ID 的先前运行记录，需先校验其 target.json 的规范路径和规范化来源与当前目标逐字节匹配。匹配后可读取 findings.json 以避免重复发现、针对盲区调整本次重点、解决冲突裁决。

限制

• 需要具备支持工具调用和并行子代理的模型的编码代理。
• 阶段 5 的结构化验证需要受信任的 JSON Schema 验证器。
• 完整覆盖需要多次运行——测试显示单次最佳运行通常发现总漏洞的大约一半。
• 该技能不能替代手动渗透测试或自动化 SAST/DAST 工具。
• 仅限授权使用。必须在获得系统所有者明确书面许可后才能使用。滥用属于违法行为。

核心原则

• 只报告可实际利用的内容，每个发现必须有具体攻击场景。
• 尽可能动态确认，可执行的声明优于仅靠论证的声明。
• 动态确定基线，与可比应用进行校准。
• 纵深防御缺口不是漏洞。
• 严重性需结合可能性与影响，分为 CRITICAL、HIGH、MEDIUM、LOW、INFORMATIONAL。
• 业务逻辑发现中 HIGH 与 MEDIUM 的关键区别在于是否击败了明确的安全边界。

应避免的反模式

• 将一切偏离 OWASP 的内容列为发现。
• 将纵深防御缺口评为 HIGH/CRITICAL。
• 忽略部署模型。
• 将设计行为视为缺陷。
• 用 LOW 发现填充报告。
• 报告没有证据的 "潜在" 发现。
• 忽略代码库做得好的地方。
• 基于错误的解析器/运行时假设构造利用。
• 跳过业务逻辑和创造性攻击。
• 过早放弃。

该技能为 agent-neutral，方法论中的 Task tool、research agent、general agent、subagent_type 等术语指代当前平台支持的等效能力。