exploration

name	exploration
description	Code exploration strategies for understanding unfamiliar codebases. Use when exploring unknown code, debugging, or analyzing architecture.
allowed-tools	Read, Grep, Glob, Task

代码库探索

本技能提供代码库探索的通用方法论，包含两种策略模式。

子文件

• isolated-research.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	派发子代理执行

搜索策略模式

## 入口点搜索

- 路由/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

---

最佳实践

1. 先评估再选择 - 根据问题复杂度选择策略
2. 记录路径 - 始终包含文件路径和行号
3. 限制范围 - 明确探索边界，避免发散
4. 输出结构化 - 使用统一格式便于后续使用
5. 复用结果 - 探索结果可保存到 memory-bank

---

核心理念：探索是理解的基础，好的探索策略能显著提升开发效率。

记住: 系统化的代码探索比随机阅读效率高十倍，好的探索策略是高效开发的基础。