mcpField
M
mapping-codebases

mapping-codebases

github.com/oaustegard开发157101 次安装1 天前更新
代码仓库

关于 mapping-codebases

mapping-codebases 是一项已弃用的技能，曾用于生成代码库的持久化符号映射。README 建议改用 tree-sitting，并介绍了归档的 v0.8.0 版本。

主要功能

  1. 01已弃用，建议改用 tree-sitting
  2. 02曾生成按目录划分的 _MAP.md 文件
  3. 03归档的 v0.8.0 快照含 codemap.py 和解析器语法

适用场景

  1. 01查阅归档的 mapping-codebases v0.8.0 版本
  2. 02用 tree-sitting 查询取代持久化代码映射

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/oaustegard/claude-skills --skill mapping-codebases

安装后在 Claude Code 中输入/mapping-codebases确认已加载。

附带文件CHANGELOG.md

详细介绍

代码库映射（已弃用）

请改用 tree-sitting。

原因

此技能会将 _MAP.md 文件写入磁盘，按目录持久化符号清单，生成一次后反复读取。在扫描成本高昂时，这种权衡是合理的。但现在扫描并不贵：tree-sitting 解析一个包含 250 个文件的仓库只需约 700 ms，并且可在内存 AST 中以不到 1 毫秒的时间回答查询。

持久化映射会带来运行时扫描不需要承担的成本：它会过时、需要重新生成、会被提交，还必须从每个遍历目录树的其他工具中排除。这样做没有任何收益。

替代命令

TREESIT=/mnt/skills/user/tree-sitting/scripts/treesit.py

# Was: codemap.py /path/to/repo          → root orientation
python3 $TREESIT /path/to/repo

# Was: reading every _MAP.md in the tree → full inventory
python3 $TREESIT /path/to/repo --depth=-1 --detail=sparse

# Was: grepping _MAP.md for a symbol     → direct lookup
python3 $TREESIT /path/to/repo --no-tree 'find:parse_input'

归档版本

最后一个可用版本是 mapping-codebases-v0.8.0 （2026-03-31）。它包含 scripts/codemap.py 和 11 个随附的 parsers/*.so 语法文件。该版本就是归档快照；此目录中的任何内容都无法重现它。

请注意，v0.8.0 存在一个潜在 Bug：codemap.py:1216 会在一个被裸 except Exception 捕获并忽略的 try 中调用未导入的 get_parser()，因此 HTML 内联 JavaScript 符号提取会静默地返回空结果。此问题不会修复。

评论

支持 Markdown