用途:为代码仓库生成分层的 AGENTS.md 知识库,记录结构、命令与约定,供智能体使用。
主要能力:以 /init-deep 命令运行,按仓库体积公式驱动 dag map-reduce 流程(quick 扫描节点提取事实,unspecified-high 写入节点负责互不重叠的子树),生成根目录与按复杂度评分的子目录 AGENTS.md,使主会话上下文在任意仓库规模下保持平稳。
用法: /init-deep 更新模式,修改已有并新建 /init-deep --create-new 读取现有后全部删除并重新生成 /init-deep --max-depth=2 限制目录深度(默认 3)
流程分五阶段:Size & Route 测量并计算节点数;Map 扫描节点输出报告;Reduce 写入节点评分并写 AGENTS.md 与摘要;Root & Verify 写根文件并校验;Snapshot & Mode 询问本地或提交模式并生成 .omo/init-deep.json。评分矩阵按文件数、子目录数、代码比例、模块边界、符号密度、导出数、引用中心性等加权,根目录始终创建,分数 >15 创建,8-15 视是否为独立领域,<8 跳过。根文件 50-150 行,子目录文件 30-80 行,子文件不重复父内容。
适用场景:需要为智能体记录仓库结构、命令与约定的项目,尤其是中大型多目录仓库。
限制:小仓库(N_quick < 4)走内联路径;节点数超过 task.dag.max_nodes_per_run(默认 64)需调整配置或按顶层目录分多次运行。本地模式下 .git/info/exclude 无法隐藏已跟踪文件。报告与摘要目录在快照后会被清理,仅保留 .omo/init-deep.json。