大型仓库分区探索与依赖理解

到了高级阶段，你会遇到几十万行、多语言、多模块的大型仓库。让代理一头扎进去读全量代码，既慢又贵还容易抓错重点。本节讲分区探索的方法：先建全局地图，再逐层下钻，让代理的理解有层次、可验证。

一、三步建立全局地图

1. 读"入口与清单"而不是业务代码。先让代理读依赖清单、构建配置、目录说明、入口文件，回答"这个仓库由哪几个子系统组成、各自用什么技术栈、怎么拼起来"。
2. 画依赖边界。要求它说明模块之间谁依赖谁、数据往哪个方向流，标注出核心模块与外围模块。
3. 圈定本次任务的相关范围。明确告诉代理："这次只动这两个模块，其它模块只读不改"，并让它列出需要读的文件清单。

二、下钻时的两个技巧

沿调用链追，不要平铺扫描。从一个入口函数出发，让代理逐层追"它调用了谁、谁调用了它"，比让它把目录里所有文件读一遍更聚焦。

用测试反推行为。大型仓库里，测试用例往往比源码更能说明"这段代码到底该干什么"。让代理先读相关测试，再去读实现，理解会快得多。

三、控制上下文膨胀

大仓库最忌讳"什么都读进来"。善用指令文件限定搜索范围，用 /clear 在探索完一个子系统后清掉上下文再开下一个，把探索结论写进项目记忆，而不是让上下文一直背着全量代码。探索结论要落成简短笔记（模块职责、关键文件、注意事项），这是后续所有改动的地基。