Snow CLI 漏洞猎人模式:专业安全分析Agent,自动检测并验证代码漏洞出报告
Snow CLI 漏洞猎人模式:专业安全分析Agent,自动检测并验证代码漏洞出报告
Snow CLI 漏洞猎人模式是这款终端 AI 编程工具内置的专业安全分析 Agent。只需在对话中执行 /vulnerability-hunting 一条指令,它便会按照 5 阶段安全分析流程自动检测代码漏洞、生成可执行的验证脚本,并输出带修复建议的详细安全报告。分析全程基于真实代码证据,覆盖 SQL 注入、XSS、认证绕过、竞态条件等常见漏洞类型,帮助新手也能完成一次"准专业级"的安全审计。
什么是漏洞猎人模式(Vulnerability Hunting Mode)
漏洞猎人模式是 Snow CLI 提供的专用安全分析代理模式。与普通对话模式不同,它不会泛泛而谈,而是遵循严格的安全分析工作流,做到"每个结论都有证据,每个漏洞都能复现"。
它的核心能力包括:
- 🎯 系统化漏洞检测:覆盖逻辑缺陷、业务逻辑错误、注入攻击、认证授权、数据泄露、依赖配置等 7 大类漏洞
- 🧪 证据驱动:所有报告必须附具体代码位置、问题代码片段与攻击路径,不做猜测
- ✅ 可执行验证脚本:为每个确认的漏洞生成可实际触发漏洞的 Proof-of-Concept 脚本
- 📄 结构化安全报告:含严重等级、影响评估、修复建议与优先级排序
- 🔒 默认只读:不修改你的源代码,只产出报告和建议;需要修复时会先征求确认
- 💬 交互式沟通:频繁提问以澄清分析范围,避免"一上来就扫全库"
模式状态会持久化保存,重启 Snow CLI 后仍保持上次的开启/关闭状态,可随时切回普通模式。
一键启用步骤:输入 /vulnerability-hunting 切换模式
启用漏洞猎人模式非常简单,三步走:
- 在终端项目目录下启动 Snow CLI;
- 在对话框输入
/vulnerability-hunting并回车; - 直接告诉 Agent 你要分析的模块,例如"分析认证模块的 JWT 处理"。
再次输入该指令即可关闭模式。
该指令由 vulnerability-hunting.ts 注册并处理,切换动作会交由会话层下发给 Agent。更多模式类指令(如 /yolo、/plan)的说明见 09.2.模式切换指令.md。
💡 小贴士:提前在 04.代码库设置.md 中开启代码库索引,可以让 Agent 用语义搜索快速定位可疑代码,分析效率明显更高。
5 阶段漏洞分析流程:Agent 如何检测并验证漏洞
漏洞猎人模式的全部行为由系统提示词 vulnerabilityHuntingModeSystemPrompt.ts 定义,执行严格的 5 阶段工作流:
阶段 1:范围定义(强制)
Agent 永远不会一次性分析整个代码库。它会先探索项目结构,列出主要模块和组件,然后通过交互式问答与你确认:
- 具体分析哪个子模块(登录流程?会话管理?Token 处理?)
- 优先关注逻辑错误、安全漏洞还是两者都查
- 是否有已知的风险点
阶段 2:漏洞分析
确认范围后,Agent 按优先级系统性地检查各类漏洞:逻辑与代码质量问题(空指针、边界条件、竞态条件、死锁)→ 业务逻辑缺陷(越权、金额计算错误、TOCTOU)→ 输入校验与注入(SQL/NoSQL 注入、命令注入、路径穿越、XSS)→ 认证与授权 → 数据暴露 → 配置与依赖 → 错误处理与日志。
阶段 3:证据收集
每个疑似漏洞都必须给出:精确的文件与行号、漏洞类型与严重等级、问题代码原文、可行攻击向量、潜在影响以及复现步骤。没有代码证据的结论不会被写入报告。
阶段 4:生成可执行验证脚本
这是该模式最有特色的部分——每个确认的漏洞都会配一个真正能触发漏洞的验证脚本(而不是文档说明),保存在 .snow/vulnerability-hunting/scripts/ 目录,例如:
.snow/vulnerability-hunting/
└── scripts/
├── verify-sql-injection.sh
├── verify-jwt-bypass.js
└── verify-race-condition.js
脚本会打印漏洞触发的精确位置和实际证据,确认存在漏洞时以非零码退出,方便接入 CI/CD 做回归检测。
阶段 5:安全报告与修复建议
最终报告输出到 .snow/vulnerability-hunting/docs/ 目录,包含:执行摘要、按严重等级(Critical/High/Medium/Low)统计的发现清单、每个漏洞的详情与验证脚本用法、具体修复建议、整体风险评估与修复优先级排序。报告语言与你的提问语言保持一致(用中文提问即得中文报告)。
实战场景:模块分析、SQL 注入验证、快速安全扫描
场景一:分析特定模块。 输入"进入漏洞猎人模式,分析认证模块",Agent 会列出登录流程、会话管理、密码重置、Token 处理等子组件供你选择,深入分析后输出如"[严重] JWT 签名验证缺失、[高危] Token 过期检查逻辑错误"的分级发现。
场景二:验证已知问题。 如果你怀疑某处用户输入存在 SQL 注入,直接说"帮我验证 searchUser 函数是否有 SQL 注入"。Agent 会定位相关代码、跟踪数据流,确认漏洞后给出位置、问题描述、严重程度,并生成 .snow/vulnerability-hunting/scripts/verify-sql-injection.sh 供你实际触发验证。
场景三:快速安全扫描。 面对大型 API 模块,可以要求"先做快速扫描找出严重问题",Agent 会优先暴露最高危漏洞(如 3 处 SQL 注入、管理接口缺少权限检查),再按你的需要逐个展开详细报告。
完整的对话示例见官方文档 11.漏洞猎人模式.md。
使用技巧与注意事项
| 最佳实践 | 说明 |
|---|---|
| 明确分析范围 | 指定具体模块和漏洞类型,而不是"扫全库" |
| 及时回应提问 | Agent 会频繁确认细节,回答能显著提升分析质量 |
| 隔离环境运行脚本 | 验证脚本在测试环境执行,切勿在生产环境直接运行 |
| 按优先级修复 | 先修严重漏洞,修复后要求 Agent 重新验证 |
| 结合人工审查 | AI 分析可能存在误报,也建议搭配其他安全工具 |
几点需要注意:模式默认只读,不会擅自改动源码;大型项目建议分多次、按模块分析;验证脚本运行前请仔细阅读内容。
相关文档
- 完整模式说明:11.漏洞猎人模式.md
- 模式切换指令:09.2.模式切换指令.md
- 敏感命令配置(配合验证脚本执行):06.敏感命令配置.md
- 模式系统提示词源码:vulnerabilityHuntingModeSystemPrompt.ts

