用途：repo-mapping 用于构建并维护基于 AST 的仓库符号与导入缓存地图，借助 ast-grep 解析代码结构。当用户要求创建、生成、更新仓库地图，查询地图状态，或映射符号/导入时使用。
主要能力：按需生成地图（/repo-map init）、增量更新（/repo-map update）、检查状态与陈旧度（/repo-map status），并通过 map-validator 代理校验输出。地图存储于平台状态目录：Claude Code 为 .claude/repo-map.json，OpenCode 为 .opencode/repo-map.json，Codex CLI 为 .codex/repo-map.json。结构包含版本、生成与更新时间、git 提交与分支、项目语言、统计（文件数、符号数）以及每个文件的哈希、语言、符号（导出、函数、类）和导入信息。
使用方式：通过 /repo-map 命令配合 init、update、status 等动作调用，支持 --force 参数。行为规则要求：若未安装 ast-grep，未经用户批准不得运行；未经明确同意不得安装依赖；init/update 后必须用 map-validator 校验；除非地图陈旧或历史被重写，优先增量更新。
适用场景：代码漂移检测、文档对齐、仓库分析。若缺少地图，会提示运行 /repo-map init。陈旧信号包括地图提交不存在（变基）、分支变更、Git 钩子标记陈旧、落后于 HEAD 的提交。输出保持简洁：init/update 显示文件数、符号数、提交与警告；status 显示陈旧度、落后提交数与最后更新时间。
限制：依赖 ast-grep；未提供具体安装命令、价格或平台支持范围等细节。