用途:该技能是知识库综合器,把 workspace/learnings.jsonl 中的临时洞见与代码库结构分析,转化为规范、互链的 Markdown 知识库 workspace/kb/,供后续智能体使用。命令为 /mantis-architecture。
主要能力:定义系统架构与数据流;映射具体组件实体;归类历史漏洞模式(按 CWE-ID 或 BugClass);生成 index.md 根目录索引;输出 dependencies.json 依赖边映射;归档 learnings 并保留每轮 KB 不可变副本。
使用方式:参数均可选,包括 --snapshot_root、--snapshot_id、--state_root、--target_root,也可用 SNAPSHOT_ROOT 环境变量。先做 LOCATOR RESOLUTION 解析 CODE_ROOT、SNAPSHOT_ID 与 snapshot_pinned,再执行 KB 快照新鲜度门(步骤 0b),据 kb_snapshot_id 与 SNAPSHOT_ID 比较选择 CURRENT、BUILD FRESH(全量或按 changed_files 范围重建)或 STALE/HALT。写入文件包括 architecture.md、entities/[component_name].md、vulnerabilities/[CWE-ID].md、index.md、dependencies.json,并在每个重写文件首行加 <!-- KB_SNAPSHOT: <SNAPSHOT_ID> --> 标记。
适用场景:软件系统、硬件/RTL、IaC、数据/ML 流水线等代码库的架构与安全知识沉淀。
限制:前置条件是 workspace/learnings.jsonl 必须存在;快照固定时不得写入 CODE_ROOT,需在私有影子副本中运行;不得用实时 VCS 命令判断 KB 新鲜度;MODE-OFF 时不加标记、不写 kb_snapshot_id;资料未提供具体收费、平台与效果信息。