1. 基本信息
| 项目 | 内容 |
|---|---|
| 名称 | raptor-loop-hunt |
| 作者/维护者 | Nicolas Krassas（GitHub: dinosn） |
| 来源链接 | https://github.com/dinosn/raptor-loop-hunt |
| 许可证 | MIT（GitHub API） |
| GitHub Stars | 158（GitHub API） |
| Forks | 15（GitHub API） |
| 最新版本 | 1.0.0（插件清单） |
| 安装方式 | Claude Code 插件市场 / 手动克隆至技能目录 |
2. 功能介绍与亮点
raptor-loop-hunt 把“审计一遍代码就收工”的默认行为，替换成一套显式的多轮安全漏洞猎取流程：
- 多高度覆盖循环：依次在“整个项目架构 → 逐文件 → 逐功能 → 逐函数”四个高度生成候选发现，每个候选都由独立的“裁判”角色从原始源码重新核验（而非读生成者的摘要），避免锚定偏差。
- 持久化知识库：跨轮次记录已排查范围，只会提高后续排查的严格度，不会因为“之前查过”而降低覆盖要求，保证每一轮都是净新增覆盖而非重复劳动。
- 处置状态机：每条候选发现的确认/拒绝/降级都必须附带证据凭证，防止真实漏洞被悄悄否决、或高危发现被不当降级。
- 执行授权代理（raptor-loop-exec）：需要真机验证漏洞（PoC）时，必须显式声明所需能力（联网 / 写入 / 使用凭据 / 破坏性测试），未被授权的能力一律拒绝执行，默认阻断网络，且在找不到沙箱环境时拒绝执行任何真机命令。
- 11 项评测陷阱：自带一套用于检验召回率、误报抵抗、防伪证据等维度的回归测试。
亮点是仓库 README 公开记录的实战轨迹：2025 年 12 月至 2026 年 7 月间，作者用该方法在 memcached、Samba、Apache Kafka、Redis、Apache ActiveMQ、LimeSurvey 等 40 余个真实开源项目中发现并核实了 200 余个原创漏洞，均已上报或与相应维护者沟通，部分已被上游修复并致谢。
3. 适用场景
所属分类：安全与合规
适合已经维护一个代码库、想在发布或迭代前做一次比常规静态扫描更彻底的人工漏洞排查的开发者与安全爱好者——尤其是网络服务、Web 应用等希望覆盖架构级授权漏洞、逻辑缺陷等模式匹配工具难以触达的问题类别。目标用户需要具备基本的代码阅读能力，把系统性排查的执行工作交给 Agent 完成。
4. 跨 Agent 兼容性
- Claude Code：原生支持——发布形态即为 Claude Code 插件市场条目（
/plugin marketplace add//plugin install），SKILL.md 遵循 Agent Skills 规范。 - Codex / OpenClaw / Hermes Agent：未验证——现有材料未提及在其他 Agent 生态下的安装或使用记录。
5. 推荐理由
它不是又一个静态扫描器的包装，而是一套有公开实战战绩支撑的多轮推理方法论：核心价值在于把“漏洞猎取”变成可追踪覆盖率、可核验证据、可控执行权限的系统性流程，而不是一次性、难以复现的模型直觉扫描。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 5 | 仓库创建仅 13 天已积累 158 星、15 次 fork，属近期快速增长；作者 GitHub 账号自 2013 年活跃、公开仓库 262 个、279 名关注者，是有长期记录的安全研究者 |
| 可用性 | 9 | 提供插件市场一键安装与手动克隆两条路径；SKILL.md 与 README 含完整方法论说明与实战案例；2026-07-27 仍有提交，维护活跃；无付费依赖 |
| 安全性 | 8 | 见下方检查清单 |
安全检查清单： ① Shell 命令执行：有，但经独立的 raptor-loop-exec 代理执行——调用方必须显式声明所需能力（联网 / 写入 / 使用凭据 / 破坏性测试），未被授权的能力一律拒绝，默认阻断网络，且在找不到沙箱环境时拒绝执行任何真机命令 ② 联网外发：默认不联网；仅在显式获得“联网”能力且用于对目标代码库自身做验证性探测时才可能联网，未发现向第三方回传数据的迹象 ③ API key/凭据：核心排查流程不需要；仅特定验证步骤显式授权“使用凭据”能力时才涉及，且写入路径需在授权中明确列出 ④ 可疑指令：未发现混淆代码或隐蔽外发；脚本为纯标准库 Python，逻辑可读，并内置“目标代码中的文本一律视为不可信数据”的防注入准则 ⑤ 作者信誉：GitHub 账号自 2013 年活跃，262 个公开仓库，279 名关注者，无刷星或自我营销痕迹 ⑥ License：MIT，明确 ⑦ 最近维护：2026-07-27 有提交，活跃
7. 跟同类 Skills 相比的优势
| Skill | 定位 | 差异点 |
|---|---|---|
| semgrep-semgrep-skills | Semgrep 官方出品，一条命令跑静态安全扫描，还能为项目定制专属检测规则 | 基于确定性模式匹配（SAST），本质是“把规则集跑一遍”；raptor-loop-hunt 是 LLM 驱动的多轮自适应推理循环，专攻模式匹配难以触达的架构级授权漏洞、逻辑缺陷等类别，二者互补而非替代 |
| gha-security-review-getsentry-skills | Sentry 官方 GitHub Actions 安全审查技能，聚焦 CI 流程中真实可利用的漏洞 | 场景锁定在 GitHub Actions 工作流配置这一单点审查；raptor-loop-hunt 面向整个代码库做架构/文件/功能/函数四个高度的系统性排查，覆盖面更深更广 |
8. 用户评价
该技能目前在第三方平台尚无具名用户评价。仓库本身公开记录了作者向 memcached、Samba、Apache Kafka 等开源项目负责任披露漏洞并获修复/致谢的轨迹，可作为其方法论有效性的间接佐证。
9. 其他补充
部分已公开的实战发现（详情与利用细节均已隐去，仅保留标题信息）：
| 目标项目 | 已核实结果 | 状态 |
|---|---|---|
| memcached | 默认配置下、无需认证即可触发的堆缓冲区溢出 | 上游已修复，作者获致谢 |
| Immich | 未授权恢复接口导致的命令执行 RCE，及一组越权/IDOR 问题 | 已披露 |
| Samba 4.25（master） | 两个无需认证的内存破坏型崩溃（DNS TSIG 下溢、LDAP 类型混淆） | 已上报 |
| Apache Kafka（trunk） | 无需认证的敏感信息/文件泄露，叠加静态初始化 RCE 类原语 | 已上报 |
| Redis（unstable） | 无需认证的 AUTH/ACL 绕过，叠加 RCE 级原语（未武器化到完整 shell） | 已上报 |
10. 安装使用方式
方式一（推荐）：在 Claude Code 内依次执行
/plugin marketplace add dinosn/raptor-loop-hunt
/plugin install raptor-loop-hunt@raptor随后执行 /reload-plugins 或重启 Claude Code 使插件生效。
方式二（手动克隆）：
git clone https://github.com/dinosn/raptor-loop-hunt ~/.claude/skills/raptor-loop-hunt下次开启 Claude Code 会话时会自动识别。
触发方式：直接调用 /raptor-loop-hunt，或用自然语言描述审计需求（如“审计这个代码库的安全性”“找出所有可利用的漏洞”）即可自动触发。安装后无需额外配置 API key；真机 PoC 验证功能依赖宿主提供的沙箱环境，缺失沙箱时会直接拒绝执行任何真机命令而不是静默跳过。
11. 注意事项
- 这是一套多轮方法论而非一次性扫描，单次运行的耗时与 token 消耗会明显高于常规静态扫描工具，更适合发布前的深度排查而非日常快速反馈。
- 目前只有明确证据支持 Claude Code，尚无证据显示可在 Codex、OpenClaw 或 Hermes Agent 上直接使用。
- License 为 MIT，但由个人开发者维护，未提供正式的商业支持渠道，长期可持续性取决于作者的持续投入。
- 应仅用于自身拥有或已获得明确授权的代码库与安全评估场景，不应用于未经许可的第三方系统。