代码库探索
本技能提供代码库探索的通用方法论，包含两种策略模式。
子文件
策略选择
| 场景 |
推荐策略 |
原因 |
| 快速了解某个模块 |
isolated-research |
一次性探索，不污染上下文 |
| 理解复杂的跨模块流程 |
iterative-retrieval |
需要多轮精炼 |
| 简单的文件/函数定位 |
直接 Grep/Glob |
无需完整探索流程 |
| 新项目初始理解 |
iterative-retrieval |
需要建立全局认知 |
| 调试特定 Bug |
isolated-research |
聚焦单一问题 |
| 架构分析和文档化 |
iterative-retrieval |
需要完整依赖图 |
通用探索方法
搜索工具选择
| 目标 |
工具 |
示例 |
| 按文件名/路径查找 |
Glob |
**/auth/**/*.ts |
| 按代码内容查找 |
Grep |
"function authenticate" |
| 读取完整文件 |
Read |
直接读取已知路径文件 |
| 深度子任务（隔离） |
Task |
派发子代理执行 |
搜索策略模式
## 入口点搜索
- 路由/API 端点
- 中间件
- main/index 文件
- 配置文件
## 定义搜索
- class/function 定义
- type/interface 定义
- 常量/枚举定义
## 使用搜索
- import/require 语句
- 函数调用点
- 类实例化
## 依赖搜索
- package.json
- import 图谱
- 模块边界
输出格式（通用）
所有探索结果应遵循统一格式：
## 探索报告
### 问题/目标
[描述探索的目标]
### 关键发现
| 文件 | 行号 | 功能说明 |
| ------------------- | ---- | -------------- |
| `src/auth/login.ts` | 42 | 登录验证入口 |
| `src/lib/jwt.ts` | 15 | Token 生成逻辑 |
### 依赖关系
[可选：模块依赖图、调用链]
### 结论
[对问题的回答]
### 后续建议
[可选：建议的下一步动作]
子策略
1. isolated-research（隔离研究）
特点：
- 在子代理中执行，不污染主上下文
- 一次性任务，快速返回
- 适合聚焦的单一问题
详细指南参阅 isolated-research.md
2. iterative-retrieval（迭代检索）
特点：
- 多轮迭代，逐步精炼
- 置信度评估驱动
- 适合复杂跨模块问题
详细指南参阅 iterative-retrieval.md
与角色系统配合
| 角色 |
探索场景 |
推荐策略 |
/cc-best:pm |
理解现有功能 |
isolated-research |
/cc-best:lead |
架构分析、技术设计 |
iterative-retrieval |
/cc-best:dev |
实现前了解相关代码 |
isolated-research |
/cc-best:qa |
理解测试范围 |
isolated-research |
/cc-best:fix |
追踪 Bug 根因 |
iterative-retrieval |
最佳实践
- 先评估再选择 - 根据问题复杂度选择策略
- 记录路径 - 始终包含文件路径和行号
- 限制范围 - 明确探索边界，避免发散
- 输出结构化 - 使用统一格式便于后续使用
- 复用结果 - 探索结果可保存到 memory-bank
核心理念：探索是理解的基础，好的探索策略能显著提升开发效率。
记住: 系统化的代码探索比随机阅读效率高十倍，好的探索策略是高效开发的基础。
