用途:Zoom Out 面向在代码库中感到方向不明的用户,目标是提供一张“地图”而非一次“导览”,帮助理解当前聚焦代码(正在讨论的文件、刚编辑的函数或用户询问的模块)与周边结构的连接关系。
主要能力(据资料):
- 一句话定位:用平实语言说明该模块/文件是什么、为何存在于系统中。
- 溯源(Ancestry):沿调用链或模块层级向上,说明谁拥有它、什么触发它,展示从入口到当前位置的路径,最多向上 2-3 层。
- 同级地图(Sibling map):列出同一抽象层级的对等模块并各配一句说明,回答“这里还有什么”。
- 关键连接:区分入站调用者与出站依赖,只列对理解该模块角色重要的连接,可用箭头或简单 ASCII 图辅助。
- 领域词汇:若该区域使用领域特定术语(如 tenant、workspace、pipeline stage),结合本代码库上下文定义最重要的 3-5 个,而非通用定义。
研究方式:阅读当前文件及其 import;查看父目录结构(如 ls 所在文件夹);用 grep 搜索主要导出的使用位置以查找调用者;浏览同级文件了解周边;阅读本地 README 或 CLAUDE.md 获取领域上下文。
限制(资料明确要求):不要解释实现细节或逐行讲代码;不要建议改动或重构,这是定位理解而非代码审查;不要输出大段文字,保持地图可快速扫读;未读代码前不要猜测架构,须先调查。
适用场景:用户不熟悉某块代码、追问“它如何融入整体”等情形。安装方式、平台与收费信息:资料暂未提供。