用途:分析仓库版本控制(VCS)历史,提取过往漏洞、安全修复、补丁及相关文件,生成结构化历史学习文件 workspace/historical_learnings.jsonl,为下游技能提供参考。命令为 /mantis-history。
主要能力:读取 VCS 日志(提交信息、标题、diff)与代码结构,判断技术栈并确定安全相关关键词;动态编写提取脚本;对提交信息预过滤、忽略非生产代码与超大 diff;批量处理 diff 并缓存结果;用轻量模型初筛、必要时升级模型;输出含 revision_id、title、description、code_paths、vuln_type、mitigation_diff、cve、history 的 JSONL。
使用方式:可选参数 --snapshot_root、--snapshot_id、--state_root 由编排器传入。VCS 日志、diff、blame 命令必须在 LIVE 仓库根目录运行,因为快照副本会剥离 .git/.hg/.repo;缓存、输出与脚本写入 --state_root/workspace/,不写入目标树。缓存为事实来源,每次运行重建输出,非空缓存不截断;检测到历史重写或 vcs_type/仓库身份变化时使缓存失效并重新提取。
限制:目标仓库与 VCS 日志须可访问;无 VCS 或未知时写入空文件并标记 UNSUPPORTED_VCS,不编造历史;浅克隆标记 PARTIAL_SHALLOW;多 VCS(.repo)需按子项目迭代或标记不支持。具体收费、平台与效果暂未提供。