用途:帮助用户理解并映射陌生仓库,生成分层 codemap(代码地图),用于代码库文档或接手不熟悉的项目。
主要能力:先检查仓库根目录是否存在 .slim/cartography.json;不存在则初始化,分析目录结构并推断需纳入的核心代码/配置文件(强制排除测试、文档、翻译、node_modules、dist、构建产物,自动遵循 .gitignore),生成哈希状态文件与各子目录的空 codemap.md,再为每个目录派生 Explorer 智能体填充内容。已存在状态时改用 changes 命令检测新增、删除、修改的文件及受影响目录,仅更新受影响地图,再执行 update 保存状态。最后汇总根级 codemap.md(Repository Atlas),记录根级文件、项目用途、各目录职责表与子地图链接,并在 AGENTS.md 中写入 ## Repository Map 段落以便自动加载(幂等,不重复)。
codemap 内容规范:责任(用软件工程术语描述目录角色)、设计模式、数据与控制流、集成点与依赖。
关键命令: python3 ~/.config/opencode/skills/cartography/scripts/cartographer.py init --root ./ --include "src//*.ts" --exclude "/*.test.ts" --exclude "dist/" --exclude "node_modules/" python3 ~/.config/opencode/skills/cartography/scripts/cartographer.py changes --root ./ python3 ~/.config/opencode/skills/cartography/scripts/cartographer.py update --root ./
适用场景:用户要求理解/映射仓库、需要代码库文档、开始处理不熟悉的代码库。
限制:属于高开销操作,仅在明确要求代码库文档时使用;测试、文档、翻译与构建依赖不得纳入;具体平台支持、收费与效果资料未提供。