项目探索是将 Glob、Grep、Read、Agent 等工具组合使用,在陌生代码库中建立从全局结构到具体实现的认知。单一工具只能完成一个动作;方案设计决定这些动作以什么顺序、什么组合达成探索目标。
一、常见探索模式
四种探索模式,覆盖从"完全陌生"到"精准追踪"的不同起点。每种模式是一种设计思路而非固定模板——理解其背后的工具选择逻辑,才能在实际场景中灵活适配。
自顶向下渐进
适用场景: 接手陌生项目、加入新团队、评估开源库——对项目一无所知,需要从零建立全局认知。
设计思路: 从信息密度最高的文件开始,逐层展开。每一层的发现指导下一层的方向,避免盲目深入。
工具链与数据流:
设计要点: 第一步选 Read 而非 Glob——README/CLAUDE.md 的信息密度远高于目录列表,一个文件就能确定后续所有搜索的方向。如果项目缺少 README,退回到 Glob 扫描顶层结构 + Read package.json 作为替代入口。
目标驱动搜索
适用场景: 已知要找什么("认证怎么做的?""支付接口在哪?"),目标明确但位置未知。
设计思路: 从关键词出发,快速收敛到目标文件。Grep 先锁定"在哪出现",Glob 补充"附近还有什么",Read 确认具体实现。
工具链与数据流: