用途:独立校验已聚合的发现(findings),对照实际源代码验证其有效性,过滤误报与噪声,是 mantis 流水线中的评审阶段。命令为 /mantis-review。
输入:读取 workspace/findings/ 下的发现 JSON 文件(含每条发现的 discovery_commit 溯源标记);读取 workspace/.mantis_state.json 中的 pass_number,以及存在时的 active_snapshot(root、snapshot_id、snapshot_pinned)。编排器可传入 --snapshot_root、--snapshot_id、--state_root,偶尔传 --target_root。代码按 code_paths 在解析出的 CODE_ROOT(被固定的快照根)下读取,快照被固定时不读实时工作树。
输出:通过辅助脚本 workspace/helpers/append_review.py 就地更新发现文件,设置 status、reasoning、repro_hints、triage_checklist 并追加 history;该脚本首行必须为 # MANTIS_HELPER_VERSION = 2,否则需重新生成。
主要能力:先做定位解析与快照溯源闸门(Step 0),确定 CODE_ROOT、判断快照模式;快照模式下按 discovery_commit 是否精确等于 SNAPSHOT_ID 分为 MATCHED 与 NOT_MATCHED,后者判为漂移并标记 NEEDS_RESEARCH、13 项 triage 全部 UNKNOWN;对 MATCHED 的发现以对抗立场默认其为误报,按 13 条负向约束评估,命中任一约束即标 FALSE_POSITIVE,否则 VALID。幂等键为 (pass_number, snapshot),避免重复写入。
限制:仅适用于 mantis 流水线场景;快照被固定时不得在 CODE_ROOT 下写入,编译或生成类命令须在私有影子副本中执行;历史日志与 VCS 命令在实时仓库根执行;命令一律用绝对路径并各自设定工作目录。其余收费、平台与效果信息暂未提供。