书名：《Agent Runtime 工程化：从工具调用循环到可恢复执行系统》
作者：陈堂会
章节：第五章 上下文工程 / 5.3 repo map 与文件摘要
电子版系列：查看完整目录
第五章 上下文工程：5.3 repo map 与文件摘要
coding agent 需要理解仓库。直接把所有文件塞进上下文不可行，所以需要 repo map。
repo map 可以包含：
- 目录树；
- 关键入口文件；
- 导出的函数、类、类型；
- import/export 关系；
- 最近修改文件；
- 测试文件与源文件对应关系；
- README、配置文件、路由文件摘要。
aider 等 coding agent 之所以重视 repo map，原因正在这里：它让模型在不读取全仓库的情况下知道'可能该看哪里'。
文件摘要要分层。第一次读大文件，可以生成摘要；当任务指向具体函数，再读取精确片段。不要让摘要替代事实。如果要修改代码，最终必须读真实片段。
系列导航
前 5 篇
- 第五章 上下文工程：5.2 Context Builder 的输入
- 第五章 上下文工程：5.1 token budget 是产品预算
- 第五章 上下文工程：导读
- 第四章 工具系统设计：4.8 验收标准
- 第四章 工具系统设计：4.7 动手任务
