接了个陌生项目?让 5 个 AI 同时帮你读代码!
【效率翻倍】接了一个陌生项目?让 5 个 AI 同时帮你读代码!
你是不是也这样——接手一个几万行的老项目,光是弄清「这个函数被谁调用」「这个模块干什么用」,就花了一整天?
读代码比写代码还累。
今天挖到一个真·黑科技,叫 Cartographer,专门解决「代码地图」这个问题——而且它靠的是让多个 AI 子代理并行工作,一个人干的活,五个 Agent 同时搞。
它是怎么工作的
Cartographer 是一个 Claude Code 插件,核心思路很野:
不是让一个 AI 慢慢读整个代码库,而是把代码库拆成若干块,同时让多个子代理(Sonnet)并行读,读完再合并成一张完整的架构地图。
具体流程:
1. 扫描:先跑一遍脚本,摸清代码库的文件结构 + 每个文件的 token 数
2. 规划:根据 token 预算(约 15 万/子代理),把文件分组
3. 并行读取:每个 Sonnet 子代理负责一组文件,独立分析
4. 合成:主 Agent 汇总所有子代理的报告,生成 docs/CODEBASE_MAP.md
整个过程,Opus 只做指挥,子代理负责干活——这本身就挺有混搭玩法的味道。
生成的地图长啥样
输出的 CODEBASE_MAP.md 包括:
– 每个文件的用途说明
– 依赖关系和调用链
– 数据流向
– 模块边界划分
– 导航指引
还有一个 CLAUDE.md 摘要,后续会话直接就能用。
增量更新,不用每次重跑
如果你已经跑过一次生成了地图,下次只要:
/cartographer
它会检查 git 变更,只重新分析改过的模块,没变的部分直接复用。懒人狂喜。
安装方法
# 1. 添加市场
/plugin marketplace add kingbootoshi/cartographer
# 2. 安装插件
/plugin install cartographer@kingbootoshi-cartographer
# 3. 重启 Claude Code,然后直接说:
map this codebase
适合谁用
- 接手老项目需要快速摸底的开发者
- 技术负责人需要给新人出代码文档
- 想用 AI 做代码审计但不想花冤枉 token 的团队
- 对「多 Agent 协作」这个范式感兴趣想看实战的
最后
说实话,这类「AI 帮你读代码」的工具有很多,但 Cartographer 的亮点是并行子代理 + 增量更新这套组合拳——不是一次性全量跑,而是智能 Diff 省 token。
黑科技不一定是造火箭,能把现有的 Agent 玩法组合出新效率的,都算。
GitHub 链接收好:
🔗 https://github.com/kingbootoshi/cartographer
⭐ 525 Stars | MIT License
评论区
登录后可评论。