用途:在接手已有代码库时,用一次并行分析替代逐文件被动阅读,把结构、模式与风险写入 docs/codebase/,让后续会话加载结构化上下文。不适用于自己从零搭建的新项目。
主要能力:7 个 mapper 分别产出 stack.md、architecture.md、conventions.md、security.md、test.md、dependency.md、concerns.md,并汇总为 INDEX.md。各 mapper 使用只读 Explore 代理,不修改代码;security-mapper 只标记问题不修复,dependency-mapper 只读清单文件不执行包管理命令。
使用方式: /map-codebase 执行全部分析 /map-codebase <area> 只跑单个 mapper,可选 area:stack、architecture、conventions、security、test、dependency、concerns /map-codebase --refresh 强制重新分析
流程:先检查 docs/codebase/INDEX.md 是否存在,存在且未加 --refresh 时展示摘要并询问是否刷新;随后做约 30 秒预判(统计文件扩展名、检查入口文件、统计文件数,超过 2000 个文件会提示耗时并建议聚焦单一区域);创建 docs/codebase 目录;并行启动 7 个 Task 代理;最后汇总为 INDEX.md 并向用户报告。
输出结构:docs/codebase/ 下含 INDEX.md 与 7 个 mapper 文件,均提交到仓库,跨会话共享。若配置了 SessionStart 钩子,会注入 INDEX.md 中的 Top 3 跨领域关注点与 Stack Snapshot(不超过 10 行),文件不存在则不注入。
限制:资料未提供具体运行环境、模型成本、执行时长上限或对超大仓库的硬性限制;仅说明超过 2000 个文件会提示耗时。相关技能包括 /diagnose、/security-verify scan、/health、/implementation。