开源雷达 2026-10-06

来源:github · 原文链接:https://github.com/elementalsouls/Claude-BugHunter · 整理:github_bot · 发布时间:2026-10-06


一、项目概览

Claude-BugHunter 是一个面向外部攻击面的 Claude Code 技能包(skill bundle),作者 Sachin Sharma(ElementalSoul)把它定位成"给 Claude 装上漏洞挖掘操作员的大脑"。它不是又一个封装了 nmap 的扫描器前端,而是把实战中沉淀的攻击方法论、载荷表、链路模板与报告纪律,写成 83 个可被模型按主题自动加载的 SKILL.md。

仓库目前约 4.8k stars、718 forks,主语言 Python,代码 MIT、内容(技能方法论、字典、正则目录、定级标准、文档)CC BY 4.0。技能的主要内容来自 681 份已公开披露的报告(其中 433 份已逐条标注可审计来源),归纳进 24 个核心漏洞类,再加上企业身份与基础设施攻击矩阵。配套 15 个斜杠命令、一个 engine/ 编排引擎、一个可独立安装的 cbh CLI,以及用于回归评测的靶场脚手架。

一句话概括它的野心:让 Claude Code 从"能聊安全"变成"知道真实世界哪些链条真的被审核通过、真的被付过钱"。

二、核心特性速览

能力具体内容工程价值
按主题自动加载用自然语言描述测试目标,相关技能自动挂载,不需要按名字调用降低认知负担,避免"记得住技能名才能用"的反模式
四层栈结构Think(方法论/红队心态)、Hunt(Web 漏洞类)、Perimeter(企业平台链)、Ship(验证与交付)覆盖从"想什么"到"交什么"的完整闭环
58 个 hunt-* 技能XSS、SQLi、SSRF、IDOR、LFI、SSTI、XXE、CSRF、CORS、原型链、HTTP 走私、GraphQL、gRPC、JWT、K8s、LLM 等每类都带检测模式、载荷、绕过表与链式组合模板
企业平台攻击矩阵M365/Entra、Okta、vCenter、SharePoint、企业 SSL-VPN、云 IAM、APK 红队管线补齐赏金思维无法覆盖的 2024–2026 CVE 链路
验证与交付纪律7-Question Gate、VRT 感知定级、OOS 反驳话术、PII 脱敏、红队交付模板把"发现"变成"被接受"的关键一环
多 harness 复用同一套 SKILL.md 可装到 Claude Code、OpenCode、Codex CLI、Hermes、AntiGravity技能资产不被单一 Agent 运行时锁定

值得注意的是,这些技能并非抽象地复述 OWASP Top 10,而是以"真实 triager 付过钱的结构"组织内容——这是它与泛化安全提示词最本质的区别。

三、系统架构设计

Claude-BugHunter 系统架构

整个系统可以按三个纵向区域理解,每个区域解决一个不同层次的问题。

交互与命令层。 最左侧有两个入口:一是用户指令(entry),即直接用英文或中文描述"我在测 acme.com,做侦察并按价值排序",Claude 依据描述自动加载对应技能;二是斜杠命令(api),/hunt、/recon、/report、/chain、/scope 等 15 个命令提供确定性的动作入口。两者都以"自动加载"或"命令编排"的方式汇入核心。除此之外还有一个旁路入口 **cbh**** CLI**(side1),它是纯 Python 的终端原生运行器,可以在不进入 Claude Code 会话的情况下调度侦察、分类、验证与报告,与核心层之间是"CLI 调度"的关系——这意味着同一套方法论既能被模型驱动,也能被脚本驱动,便于接进 CI 或批量作业。

技能编排核心。 中央是技能引擎(core,对应 engine/skill_map.py 与 engine/engine.py)。它做两件事:把目标特征映射到技能集合,以及把整个 engagement 的阶段状态持久化。技能引擎向右连着 Burp MCP(side2),通过 “Burp 联动” 把 Claude 与已授权的代理流量打通;向下连着范围校验(guard),也就是 7-Question Gate 与 scope.py 里的范围判定。这一层的设计意图很明确:先校验,再放行技能。范围不是文档里的一句话约定,而是编排路径上一个真实的闸门——未通过校验的目标不会顺滑地进入攻击技能。

能力与外部层。 闸门通过后进入技能库(tools,83 个 SKILL.md + 15 个命令),技能库向下接两处:一是报告语料(data,681 份披露报告归纳出的模式),为每个技能提供"真实案例依据";二是侦察工具(exec,subfinder、httpx、nuclei、katana 等 ProjectDiscovery 工具链),负责把技能里的判断落成实际的外呼。这条 放行技能 → 报告语料 / 调用侦察 的路径,正是"知识"与"执行"分离的设计:技能本身是可审计的 Markdown,执行交给成熟工具。

三个区域合起来,形成了一条从自然语言意图到范围约束下的技能选择再到真实工具调用的完整链路。分层清晰带来的直接好处是:想扩展能力,加一个 SKILL.md 即可,不需要改编排逻辑。

四、核心工作流

六阶段漏洞挖掘主循环

主循环是一个六阶段、非线性的流程。所谓非线性,是指从任一阶段都可以回溯——验证阶段发现假设不成立,应该退回情报收集而不是硬编报告。中间由"技能自动路由"作为枢纽,每次阶段切换都会触发技能重载;同时有两条侧枝贯穿全程:状态写回(engagement 目录下的状态文件被持续更新)与记忆沉淀(跨目标复用模式)。

  1. 侦察收集(subfinder)。子域枚举、证书透明日志(crt.sh)、被动 DNS、OSINT 与身份织物测绘。目标是把资产面从"一个域名"扩成"一片可排序的攻击面"。
  2. 面映射(attack surface)。把收集到的资产整理成结构化清单,识别技术栈、暴露的组件、认证方式(OAuth/SSO/SAML)、对外 API 类型,为下一步排序准备特征。
  3. 排序(rank surface)。这是枢纽所在的位置——技能路由在此决定"先打哪里"。GraphQL 开了 introspection 的 API 子域、SSO 回调参数可疑的认证子域,会比一个静态营销站优先。排序不是按工具输出排序,而是按可能的漏洞链价值排序。
  4. 漏洞挖掘(hunt-* skills)。进入具体漏洞类的检测:模式匹配、载荷投放、绕过表对照、链式组合。58 个 hunt-* 技能在这里被逐个唤起,企业资产则切换到 Perimeter 层的平台链路。
  5. 验证定级(7-Question Gate)。提交前的过滤网,核心两问是"资产是否在范围内"与"是否落在项目接受的危害清单上"。这一步同时承担降噪职责——过滤掉自欺欺人的"疑似"。
  6. 报告提交(H1 / Bugcrowd)。按平台语气与 VRT 标准组织报告,附带证据脱敏后的截图与复现步骤。 与此并行的是两条贯穿线:状态写回保证一次 engagement 里发现的 IP、凭证、假设不会散落在聊天记录中;记忆沉淀让下一个目标的侦察不再从零开始。这个循环的价值不在于阶段划分本身,而在于它把"什么时候应该停下、回退、重排"写成了显式规则。

五、核心模块解析

模块职责
engine/编排核心。scope.py 做范围判定,recon.py 驱动资产发现,osint.py 处理开源情报,memory.py 承担跨目标记忆,state.py 持久化 engagement 状态,skill_map.py 把目标特征路由到技能,agent.py 与 engine.py 串起全流程
skills/83 个 SKILL.md。58 个 hunt-* 覆盖 Web 漏洞类,10 个企业平台攻击技能,6 个报告与验证技能,5 个侦察与 OSINT 技能,4 个方法论与心态技能
commands/15 个斜杠命令:/hunt、/recon、/report、/validate、/triage、/scope、/surface、/intel、/chain、/autopilot、/pickup、/remember、/memory-gc、/token-scan、/web3-audit
cbh/可 pipx 独立安装的终端运行器,内含 cli.py 与数据文件,让编排能力脱离 Agent 会话单独使用
eval/评测脚手架:DVWA、OWASP Juice Shop、PortSwigger 靶场的批量与并行运行器,外加误报用例集(fp_app.py、fp_cases.json)与基线记录
scripts/安装与维护脚本:跨 harness 安装、技能目录生成、技能 lint、CVE 索引刷新、文档计数校验、star 曲线生成
research/reports/研究性产出与报告素材

eval/ 的存在值得单独说一句。多数"AI 安全技能包"只交付提示词,无法回答"装了之后到底强了多少"。这里有误报用例集、有靶场批量跑分、有 BASELINE.md 基线,说明作者把"能力是否真的提升"当成可测量问题——这在同类项目里并不常见。

六、特色能力

红队心态与中途 IR 检测。 redteam-mindset 解决的是"保守默认值把真问题提前掐掉"的问题:在被防护的资产上,WAPT 思路会过早停止测试,而红队思路会继续寻找绕过链。mid-engagement-ir-detection 则处理一个常被忽略的现实——客户 SOC 可能在你确认 SQLi 后 30 分钟内完成修补,外部攻击者可能在你测试期间锁掉 14 个账号。没有显式的检测方法论,这些变化在长会话里是完全不可见的。

企业平台攻击链。 M365/Entra、Okta-as-IdP、vCenter/Workspace ONE、SharePoint 本地部署(含 ToolShell 与遗留 SOAP)、Cisco/Fortinet/Citrix/Palo Alto/Pulse/SonicWall/F5 等 SSL-VPN 设备的当前 CVE 链,以及拿到凭证之后的提权路径。这部分是赏金思维天然覆盖不到的:它需要特定平台的贸易手法,而不是通用的注入技巧。

凭证后提权模型。 cloud-iam-deep 回答一个侦察阶段经常撞上的问题——拿到 AWS key、JWT、GCP service account JSON 之后,这些凭证到底授予了什么、能不能横向、能不能提权。IMDS 链、STS AssumeRole、跨账号 confused deputy 都在覆盖内。

证据卫生与交付。 evidence-hygiene 做 PII 脱敏与截图清洗(作者自述曾因截图泄漏 cookie 与受害人信息踩坑),redteam-report-template 提供企业红队需要的 50KB+ Markdown/DOCX 交付格式,bugcrowd-reporting 则包含研究者侧卫生习惯——Bugcrowdninja 别名、账号状态复原、友好测试者姿态,这些细节直接影响目标方风控团队对你行为的判断。

七、工具链与生态

安装与使用可以走两条路,插件市场是最快的:

# 方式 A:Claude Code 插件(推荐)
/plugin marketplace add elementalsouls/Claude-BugHunter
/plugin install claude-bughunter@elementalsouls

# 方式 B:克隆 + 脚本安装
git clone https://github.com/elementalsouls/Claude-BugHunter.git
cd Claude-BugHunter && bash scripts/install.sh

# 多 harness 一次铺开,并接入 Burp MCP
bash scripts/install.sh --all --burp-mcp

# cbh CLI 独立安装(不需要克隆)
pipx install git+https://github.com/elementalsouls/Claude-BugHunter

插件路径下 83 个技能与 15 个命令以 claude-bughunter: 命名空间加载,随插件版本更新,不往 ~/.claude/ 里拷文件;复制安装路径则额外获得 hunt engagement 脚手架。cbh 是独立入口,两种安装都能补上。

多 harness 支持是这套技能包的一个务实设计:--all 会探测已安装的 harness,把技能分别投放到 ~/.claude/skills、~/.agents/skills、~/.hermes/skills、~/.gemini/config/skills。知识层五个运行时通用,斜杠命令与 /hunt 引擎则刻意保留为 Claude Code 专属。

外部依赖上,它押注在成熟工具:Burp Suite + MCP Server 扩展负责代理与流量理解,ProjectDiscovery 全家桶(subfinder、dnsx、httpx、katana、nuclei)负责资产发现,SecLists 与 Assetnote 字典负责爆破语料。

生态协作也做得比较干净:姊妹项目 Claude-OSINT 与其共享两个侦察技能,且约定在这边做规范维护、那边再导出,二者字节一致;两个安装器都记录 manifest,重复技能会跳过,--uninstall 会保留另一方仍拥有的技能,因此同时安装不会互相破坏。上游基础技能来自 shuvonsec/claude-bug-bounty(8 个技能 + 15 个命令),生成器工具 public-skills-builder 未随包分发,归属在 NOTICE 与 docs/credits.md 里写得很清楚。

八、部署与安全

安装方式本身不复杂,真正的门槛在授权边界。项目在 README 中直接声明适用范围:你拥有的资产,或持有书面授权可评估的资产——赏金项目范围内的资产、渗透测试授权书覆盖的目标、CTF 靶场、自己的基础设施。

这一定位被写进了代码路径:技能包内置校验闸门,指向未经验证的第三方目标时会自动触发,triage-validation 的 7-Question Gate 中 Q3 明确询问资产是否在范围内,Q2 询问是否属于项目接受的危害类型。技能包明确排除的内容包括:对未授权目标武器化 0-day、后渗透工具、恶意软件开发、大规模目标打击基础设施,完整立场见 SECURITY.md。

还有一个容易被忽略的运行层现实:Anthropic 的模型侧有实时网络安全防护,默认会拦截"漏洞利用或攻击性安全工具开发"相关请求,即使是授权范围内的工作也可能撞上拒绝——这不是技能包导致的。从事授权攻防(渗透、赏金、红队)的人应申请 Anthropic 的免费 Cyber Verification Program(CVP),让防护策略对合法双用途工作做调整(大规模数据外泄与勒索软件开发仍被禁止且不可调整)。

另一个坑是模型切换。在 Opus 5 上,少数高风险网络请求——官方点名了漏洞利用生成、基于二进制的漏洞扫描、渗透测试——会回退到 Opus 4.8 而不是被拒绝,响应会带上模型标注,但在长 agentic 会话里很容易被划过,看起来像是模型"突然变笨"。处理方式分三种:审自己代码就如实说是防御性审查;做授权攻防就去申请 CVP,而不是把攻击性工作改写成防御性措辞骗分类器;只是不想要切换,就在设置里关闭自动切换。/hunt 在第一轮就显式声明 engagement 语境(授权、有范围、可修复的发现),正是为了不让上下文处于默认隐含状态。

九、适用场景

适合的用法相当具体:HackerOne / Bugcrowd / Intigriti / Immunefi 上的赏金狩猎,尤其是需要按类检索检测模式与链式组合的场景;外部红队项目的初始访问阶段,针对有监控的企业资产;Web 应用与 API 的常规渗透测试,覆盖 OWASP 映射的漏洞类;云配置错误与拿到凭证后的提权判定;以及 DVWA、Juice Shop、Hacker101、testphp.vulnweb.com 等训练平台的练习。

明确不适合的部分同样重要,且作者把它写成了设计决策而非能力缺口:内网 AD 攻击(BloodHound、Kerberoasting、DCSync、AD CS 滥用、ntlmrelayx 等)、C2 框架贸易手法(Cobalt Strike、Sliver、Mythic)、后渗透与持久化(LSASS dump、黄金/白银票据、令牌窃取)、免杀与 EDR 绕过、iOS 渗透与硬件/RF/ICS、二进制与内核利用。这些阶段有完全不同的操作风险画像,需要独立的工具与判断。对同时包含域接管链与横向移动的内部红队项目,这个包在那些阶段帮不上忙——与其让人在项目中段才发现,不如一开始就说清楚。外网面到内网工具(Impacket、NetExec、Rubeus、Certify、BloodHound)的交接被有意留在范围之外。

十、总结评价

Claude-BugHunter 真正值钱的地方不是"83 个技能"这个数字,而是内容的来源结构:681 份公开披露报告 → 24 类漏洞模式 → 每类技能里的检测模式、绕过表与链式模板。这意味着模型在建议你测什么的时候,参照的是"真实审核通过并付过钱的结构",而不是一篇 OWASP 页面的抽象复述。433 份可按条审计的引用,把这个说法变成了可验证的声明。

第二个值得肯定的点是对边界的处理。同类项目常见的问题是野心外溢——声称覆盖一切,结果在关键阶段掉链子。这里反其道而行:内网 AD、C2、免杀、后渗透全部明确划出,并解释为设计决策。附带的好处是安全叙事清晰——它服务的是授权的外部攻击面工作,7-Question Gate 与 SECURITY.md 把这一点写进了执行路径而不只是文档。

第三个是工程完整度。eval/ 里有误报用例集与靶场跑分基线,cbh 提供脱离 Agent 的终端入口,安装器跨五个 harness 分发且彼此不冲突,还有技能 lint、文档计数校验、CVE 索引周更这些"长期维护才会想到"的脚本。这不像一次性的提示词合集,更像一个有维护节奏的知识工程产物。

该说的局限也说:技能包不会替你判断,也不改变 LLM 在长链路推理上的固有波动;模型侧防护与模型回退是运行时的外部变量,技能包只能通过声明语境来降低摩擦,无法消除;企业平台的 CVE 矩阵天然需要季度刷新,否则会在真实目标前过期。对新手而言,最大的风险是把它当成"自动挖洞机"——它提供的是操作员的判断框架和语料,判断仍由人做。

推荐给谁:有授权在手的赏金猎人与外部红队成员、需要把方法论固化成可复用资产的安全团队、以及用靶场系统学习真实链条结构的安全工程师。不推荐给谁:寻找一键扫描器的人,以及需要内网 AD 或后渗透能力的内部红队。

参考链接:GitHub 仓库 · 项目官网与文档