技能介绍

痛点：安全扫描工具链割裂

安全团队在做资产测绘和漏洞验证时，往往需要把 BBOT、自定义脚本、监控面板拼在一起用。模块选择靠翻文档、预设靠手抄、扫描状态靠轮询日志，一次多目标扫描的参数散落在各处，自动化脚本也很难复用。

工作机制与核心能力

该技能以 MCP 服务器方式封装 BBOT，把常用操作拆成可调用的工具函数，全部走 scripts.tools：

模块与预设管理：list_bbot_modules、list_bbot_presets 直接列出当前可用模块和预设。
扫描生命周期：start_bbot_scan 接收 targets（必填，域名/IP/URL 逗号分隔），可选 modules、presets、flags；no_deps 默认为 true，可跳过依赖安装避免 sudo 弹窗。
状态与结果：get_scan_status 查单个扫描，get_scan_results 按 scan_id 拉取结果并支持 limit（默认 100），list_active_scans 列出全部活跃扫描。
等待与依赖：wait_for_scan_completion 支持 timeout、poll_interval、include_progress，适合在长任务中做进度汇报；get_dependency_info 说明依赖管理细节。

工作流程固定为五步：先校验 API 密钥，缺失时用 AskUserQuestion 交互获取，再通过 scripts.config.set_api_key(key) 保存；随后根据意图选工具、提取参数（缺失则追问）；以关键字参数调用函数；最后把返回的 result["raw"] 整理展示，并附带 success、message 供调用方判断。

适用边界与注意事项

密钥是硬前提：所有工具都依赖 XBY_APIKEY，无密钥时禁止自行搜索或编造数据，必须向用户索要。
参数完整性：start_bbot_scan 的 targets、get_scan_status 的 scan_id 等必填项缺失时，需主动询问，不要跳过。
依赖安装：默认 no_deps=true 可避免 sudo 提示，适合无交互的 CI 环境；需要完整模块能力时再手动处理依赖。
不适合的场景：需要自定义 BBOT 模块源码或深度调试引擎逻辑时，该封装只覆盖运行层面，不替代直接操作 BBOT 仓库。