GitHub 热榜上手|security-audit-skill:一个 skill 跑完 6 阶段安全审计

GitHub 热榜上手|security-audit-skill:一个skill跑完6阶段安全审计

📌 本文整理自官方文档与社区公开资料,未做真机实测。

安全审计最头疼的不是"找不到漏洞",而是找到之后没人信。cloudflare/security-audit-skill 本周 +11908 star(总数 56081),核心卖点就一句:让 coding agent 跑完侦察→狩猎→验证→出报告全流程,每条发现都过独立验证器,输出机器可读。

项目介绍

这是 Cloudflare 官方的 coding-agent skill,定位是"把 agent 变成安全审计员"。README 写明:它是 Cloudflare 漏洞发现 harness 的单仓库起点——harness 后来扩展为多阶段全量系统,这个 skill 是演进前的那个 repo。

审计分 6 个阶段:

  1. 侦察:映射架构、信任边界、输入面,产出 architecture.md 和 coverage-ledger.json
  2. 覆盖率驱动狩猎:从 ledger 单元派独立 hunter,用 coverage critic 找盲区
  3. 候选验证:每个候选交给全新 verifier,任务是证伪
  4. 结构化输出:写入 findings.json,按 report-schema.json 校验
  5. 独立记录验证:fresh agent 复核最终源码声明,material 替换再走一轮
  6. 目标中立报告:生成 REPORT.md、FINDINGS-DETAIL.md、NEEDS-VALIDATION.md

判定只有三种:confirmed(完整源码追踪 + 有界观测结果)、needs_validation(精确的未解决事实,不标严重度)、rejected(已被证伪)。多次运行同一 repo 是增量式的——用旧 ledger 和 findings 定位缺口、复验变更源码,不把 stale 工作当"已覆盖"。

上手指南

本文整理自官方文档与社区反馈,未做真机实测。

仓库为 JavaScript 实现,克隆命令(逐字):

$ git clone --depth 1 https://github.com/cloudflare/security-audit-skill

记录中该命令返回 exit=128,报错:

fatal: could not read Username for 'https://github.com': Device not configured
fatal: expected flush after ref listing

这是执行环境未配置 git 凭据所致,非仓库本身问题;正常终端重新执行即可。

核心文件(摘自 README 表格):

文件 作用
SKILL.md 设置、核心原则、平台术语、工作流概述、审计反模式
RECONNAISSANCE.md 阶段 1 侦察 prompt 与综合指令
HUNTING.md 阶段 2 编排、狩猎方法、验证规则
ATTACK-CLASSES.md 核心攻击类别

踩坑记录

以下全部来自真实 issue 或执行记录,逐条标注来源:

  • 克隆即报错:git clone --depth 1 返回 exit=128,Device not configured。无凭据环境直接卡住。(来源:本文执行记录)
  • 并行 subagent 被杀:Gemini 3.1 pro (High) 下,Antigravity 平台 kill 并行 subagent。(来源:issue #11,3 评论)
  • 输出被平台拦截:跑 2.5 小时后输出被 Codex 隐藏,提示需注册 Daybreak。(来源:issue #77,4 评论)
  • 修复验证不够:remediation 只验证"攻击失败",未证明合法用法仍正常。(来源:issue #88,3 评论)
  • 类级盲区:盲测对比(1 个 seeded target,3 方法各 n=3)发现 6 个 class-level gap。(来源:issue #20,5 评论)

使用说明

根据 README,使用流程:

  1. 将 skill 文件(SKILL.md 等)接入你的 coding agent;支持的平台术语在 SKILL.md 中有说明。
  2. 父 agent 在创建 ledger 后及每次 ledger 更新后运行 validate-coverage-ledger.cjs。
  3. 阶段 4 及阶段 5 每次替换后运行 validate-findings.cjs。
  4. 最终从 verified records 和 coverage ledger 派生三份报告文件。

判定逻辑(README 原文):confirmed 要求完整源码追踪 + 有界观测结果;needs_validation 只记录精确的未解决事实,不标严重度;rejected 记录被证伪的候选。多次运行叠加:skill 用旧 ledger 和 findings 定位缺口、复验已变更源码。

总结

该用的人: 想系统练手"用 coding agent 做安全审计"的开发者;想理解 6 阶段流水线如何编排的;想给现有 agent 加结构化安全审计 skill 的。

不该用的人: 期望"一键扫描出报告"的黑盒体验——它是 orchestration skill,需要你理解每阶段在做什么;没有 coding agent 基础设施(agent runtime、subagent 并行能力)的,上手成本偏高。


本周共带来 7 个 GitHub 热榜项目,后续每天更新一篇。关注我,跟着热榜项目练手。

互动: 6 阶段里,你觉得最容易被"橡皮图章"化的是阶段 3(候选验证)还是阶段 5(独立记录验证)?选一个,一句话说理由。


做自动化这几年,最耗时间的从来不是写代码,是摸清每个平台的脾气。

这篇里提到的坑,都是真金白银踩出来的。
这类坑我还攒了不少,下一篇准备写批量发布的幂等与重试。
想先看哪块,评论区点个名。

posted @ 2026-11-09 05:37  钱栈up  阅读(28)  评论(0)    收藏  举报