用途：mantis-summarize（命令 /mantis-summarize）是仓库映射器，作为可选预处理阶段，为每个含源码的目录生成安全导向的确定性摘要 mantis-summary.md，从而大幅减少策略规划（/mantis-plan）所需上下文，并为研究者（/mantis-researcher）提供快速参考地图。
主要能力：自底向上（后序）遍历目录树，先摘要子目录再摘要父目录；分析某目录时只传入该目录的本地源文件及其直接子目录的 mantis-summary.md，不传子目录原始源码；读取 workspace/historical_learnings.jsonl（若存在）以纳入历史漏洞与修复信息；摘要内容涵盖核心组件、API 端点与导出、信任边界与外部输入、敏感操作（解析器、加密、内存管理）、历史漏洞与修复；对超大目录可生成逐文件摘要或分块处理以控制 token。
使用方式：技能会先解析定位符，确定 CODE_ROOT（优先级：--target_root、--snapshot_root/SNAPSHOT_ROOT、state_root/workspace/.mantis_state.json 中的 active_snapshot.root，最后回退当前目录）；随后编写并执行遍历脚本（Python 或 bash），忽略 node_modules、vendor、.git、构建产物和 tests/；脚本完成后通知用户。所有 shell 命令使用绝对路径并自行设置工作目录。
输出与限制：MODE-OFF（无 active_snapshot，默认）与 HALT 模式下，将 mantis-summary.md 写入对应源码目录并原地覆盖；PINNED 模式（snapshot_pinned 为 true）下跳过摘要，不写入任何文件，CODE_ROOT 只读，禁止在 CODE_ROOT 下写入，编译或生成产物须在私有影子副本中运行。摘要文件须对 VCS 脏检查不可见，并在同步前从目标树删除。若 snapshot_pinned 为 true 且未走 --target_root 路径，需校验 CODE_ROOT/.mantis_snapshot_id 与 SNAPSHOT_ID 一致，否则停止并报“snapshot sentinel mismatch”。VCS 历史提取与 diff/blame 在含 .git/.hg/.repo 的实时仓库根运行，而非快照副本。摘要目标为数千词以内。其余细节暂未提供。