用途:在真实工作开始前为仓库建立或刷新一份持久侦察缓存。适合首次进入陌生项目、需要映射仓库、需要熟悉代码库的场景。它被描述为一个小型辅助工具,而非仪式化流程:0–1 个智能体、无需预检确认、无 run_dir。运行一次后,后续 nuke 流程可“热启动”。
主要能力:由一名 clerk 级别侦察者(在无法生成子智能体时也可由编排器直接执行)按统一规则产出:技术栈(清单、语言、框架、工作区布局);约定(提炼 CLAUDE.md、AGENTS.md、.cursorrules、copilot-instructions 等项目指示文件,界定何为有意设计);闸门(按路径前缀的 test·typecheck·lint 表,来自清单脚本到 CI 再到回退表,无闸门区域会被标记);架构草图(顶层区域、入口点、层间导入方向,一屏而非长文);文件类型到技能的映射(本地技能库列出一次并匹配);安全面检测(web、CLI、library、daemon、infra、ai)。地图带有日期与 HEAD 标记;--refresh 或发现过期地图时,依据标记以来的 git 历史核对并更新增量,不重扫未变更内容。
使用方式与限制:对代码库只读,唯一写入是 .nuke/repo-map.md,不使用 git 命令。地图只记录持久事实,不写单次运行的范围或发现。无法分类的区域标记为 unmapped 而非猜测。交回时五行以内:技术栈一行、闸门行数及无闸门区域、检测到的面、技能映射匹配、地图路径;其余都留在图中。具体模型层级、适配器细节与安装命令暂未提供。