SuperAPI AI 工具集

cartography

通用与其它

查看项目

更新于 10-15 20:29

技能介绍

用途:帮助用户理解并映射代码仓库,生成分层代码地图(codemap),适用于需要理解或记录代码库、开始接触陌生代码库的场景。

主要能力:检查仓库根目录是否存在 .slim/cartography.json 状态文件;初始化时分析仓库结构、推断核心代码与配置文件模式(强制排除测试、文档、翻译、构建依赖等,并自动遵循 .gitignore);通过 cartographer.py init 创建状态文件与各子目录的空 codemap.md;通过 changes 检测新增、删除、修改文件及受影响目录;通过 update 保存新状态;委派 Explorer 代理为每个目录填写 codemap.md,内容涵盖职责、设计模式、数据与控制流、集成点;最终由 Orchestrator 创建或更新根 codemap.md 作为主入口,汇总各子地图职责并交叉引用路径。

使用方式:若状态不存在,运行 python3 ~/.config/opencode/skills/cartography/scripts/cartographer.py init --root ./ --include "src//*.ts" --exclude "/*.test.ts" --exclude "dist/" --exclude "node_modules/";若已存在,运行 cartographer.py changes --root ./ 查看变更,仅更新受影响目录,再运行 cartographer.py update --root ./ 保存状态。

限制:资料未提供收费、价格、平台支持范围等信息;排除规则为强制要求,测试、文档、翻译等不应纳入;具体代理数量与运行环境细节暂未提供。