技术与工程已解决
代码仓库级别的 AI 理解
让 AI 理解整个代码仓库而非单个文件：仓库地图、依赖图与检索的结合。
问题正文
单文件的局限
只看单个文件，AI 不知道这个函数被谁调用、这个类继承自什么、改一行会影响哪些模块。仓库级理解是编码 Agent 质量的分水岭。
仓库地图技术
把仓库的目录结构、模块职责、关键接口压缩成一份地图放进上下文；Agent 需要细节时再按图索骥读取具体文件。
检索与地图的结合
代码语义检索（按功能找代码）、符号索引（函数定义与引用）、仓库地图，三者结合让 Agent 的定位能力接近人类工程师。