explorationlisted

# 代码库探索 本技能提供代码库探索的通用方法论，包含两种策略模式。 ## 子文件 - [isolated-research.md](isolated-research.md) - 隔离研究（快速一次性探索） - [iterative-retrieval.md](iterative-retrieval.md) - 渐进式检索（多轮迭代探索） ## 策略选择 | 场景 | 推荐策略 | 原因 | | -------------------- | ------------------- | ------------------------ | | 快速了解某个模块 | isolated-research | 一次性探索，不污染上下文 | | 理解复杂的跨模块流程 | iterative-retrieval | 需要多轮精炼 | | 简单的文件/函数定位 | 直接 Grep/Glob | 无需完整探索流程 | | 新项目初始理解 | iterative-retrieval | 需要建立全局认知 | | 调试特定 Bug | isolated-research | 聚焦单一问题 | | 架构分析和文档化 | iterative-retrieval | 需要完整依赖图 | --- ## 通用探索方法 ### 搜索工具选择 | 目标 | 工具 | 示例 | | ------------------ | ---- | ------------------------- | | 按文件名/路径查找 | Glob | `**/auth/**/*.ts` | | 按代码内容查找 | Grep | `"function authenticate"` | | 读取完整文件 | Read | 直接读取已知路径文件 | | 深度子任务（隔离） | Task | 派发子代理执行 | ### 搜索策略模式 ```markdown ## 入口点搜索 - 路由/API 端点 - 中间件 - main/index 文件 - 配置文件 ## 定义搜索 - class/function 定义 - type/interface 定义 - 常量/枚举定义 ## 使用搜索 - import/require 语句 - 函数调用点 - 类实例化 ## 依赖搜索 - package.json - import 图谱 - 模块边界 ``` --- ## 输出格式（通用） 所有探索结果应遵循统一格式： ```markdown ## 探索报告 ### 问题/目标 [描述探索的目标] ### 关键发现 | 文件 | 行号 | 功能说明 | | ------------------- | ---- | -------------- | | `src/auth/login.ts` | 42 | 登录验证入口 | | `src/lib/jwt.ts` | 15 | Token 生成逻辑 | ### 依赖关系