SuperAPI AI 工具集

repomap

编程与开发

查看项目

更新于 10-15 17:17

技能介绍

用途:为当前项目生成仓库地图,作为代码库的结构概览,便于整体浏览、定位“某功能在哪”、跨模块重构、熟悉陌生区域或规划多文件改动。

主要能力:先验证当前目录是否为 git 仓库,若不是则告知用户。随后按顺序查找 repomap 安装位置并取首个命中:$REPOMAP_HOME、$HOME/claude-repomap-command、$HOME/.claude-repomap-command、$HOME/.local/share/claude-repomap-command。若这些位置都没有 scripts/run.sh,则提示用户克隆仓库:git clone https://github.com/ariadoss/repomap.git ~/claude-repomap-command

使用方式:找到安装目录后,用辅助脚本运行,命令为 <REPOMAP_DIR>/scripts/run.sh repomap -o REPOMAP.md(<REPOMAP_DIR> 替换为实际路径)。辅助脚本会自动检测 >= 3.8 的 Python 解释器,首次运行自动安装 tree-sitter-languages,若 PATH 中没有兼容 Python,会回退到 uv/pyenv/asdf。若报错“no compatible Python found”,需把打印出的安装选项转告用户。

完成后:若 REPOMAP.md 有内容,确认成功并概述映射内容,然后询问是否要在 CLAUDE.md 中加入规则,让后续会话自动引用该地图。若同意,先检查项目根目录 CLAUDE.md 是否已含标记 <!-- repomap-rule -->,已含则跳过;否则追加相应规则块(文件不存在则创建,追加前留空行)。若用户不同意,则提示可自行阅读。

限制:若 REPOMAP.md 为空(0 字节或仅空白),删除该空文件并告知项目可能使用了不支持的语言;若命令报错,需展示错误输出以便排查。