代码库地图 是做什么的?
定位用户任务所需的代码,并在需要时保留有用的导航信息。区分源代码证据、声明的配置和观察到的运行时行为。
根据要求的交付物进行路由
- X 在哪里 / 快速导航: 读取相关的现有地图,并根据检出版本验证其路径。用简短流程和入口点链接回答;无需编写文档。
- 创建 / 刷新持久化地图: 使用 orient。保留现有文档布局和本地说明。
- 架构可视化: 使用 diagram。无需先生成文档套件,即可通过聚焦的源代码遍历来绘制图表。
并行发现
对于大型仓库,将独立的有限区域委派出去(例如 API/认证、工作进程/数据、UI/导航)。每个侦察任务都是只读的,并返回真实的路径/符号、入口点、依赖关系(附证据)、不确定性以及检出的确切版本。不要要求每个侦察任务扫描整个树。
父进程拥有索引、共享文档和跨区域连接。在写入之前,验证边界声明、去重并协调不一致的名称。如果代理不可用或范围较小,则顺序执行相同的聚焦发现。委派只有在能节省工作量时才有用;切勿为每个文件创建一个代理。
证据与完成
包的存在并不证明它在生产环境中运行;导入并不证明存在网络部署。记录已检查的内容和仍然未知的内容。使用可用工具验证所有交付的本地链接和图表源语法。报告实际验证结果和最佳起始文件,而不是整个仓库列表。
回答的语气
直击重点。没有阶段性的开场白,没有“不是 X 而是 Y”,没有聊天残留,没有重要性填充。短句与长句交替出现。事实和限定词应与证据保持同等强度。