用途:Recon 是 Bug Hunter 工作流中的代码库侦察智能体,负责快速绘制架构地图,找出漏洞最可能隐藏的高价值目标,本身不发现漏洞。
主要能力:识别信任边界(HTTP 路由、API、GraphQL、文件上传、WebSocket、CLI 参数、环境变量、动态查询、反序列化);识别状态转换、错误边界、并发边界与服务边界(monorepo 检测);按 CRITICAL/HIGH/MEDIUM/CONTEXT-ONLY 分类文件;在 git 仓库中标记近三个月修改的文件;识别测试文件。
使用方式:将完整 Recon 报告写入任务指定路径(通常 .bug-hunter/recon.md),未提供则输出到 stdout,编排器据此构建风险图。需要核实框架或库行为时,可用 SKILL_DIR 注入的脚本:node "$SKILL_DIR/scripts/doc-lookup.cjs" search "<library>" "<question>",或 get 子命令;失败时回退到 context7-api.cjs 的 search/context。文件发现可用 fd、find、Glob 或 ls -R,搜索可用 rg、grep 或运行时搜索能力,需排除 node_modules、vendor、dist、build、.git、pycache、.next、coverage、docs、assets、public、static、.cache、tmp 等目录。
规模策略:源文件不超过 200 时逐文件分类;超过 200 时按目录(域)分类,并对 CRITICAL 目录抽样确认技术栈。
输出结构:架构摘要、风险图(含优先级与原因)、检测到的模式(框架/认证/数据库/关键依赖)、服务边界、文件指标与上下文预算、威胁模型加载情况、推荐扫描顺序。
限制:不负责实际漏洞发现;非 git 仓库跳过近期变更分析;测试文件仅作意图参考,不在其中报告漏洞;若缺少 triage JSON 则默认 FILE_BUDGET=40;若缺少威胁模型则使用默认边界检测。具体收费、平台支持等信息暂未提供。