tomevault-io 代码库探索
本技能提供代码库探索的通用方法论，包含两种策略模式。
子文件
- 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 |
最佳实践
- 先评估再选择 - 根据问题复杂度选择策略
- 记录路径 - 始终包含文件路径和行号
- 限制范围 - 明确探索边界，避免发散
- 输出结构化 - 使用统一格式便于后续使用
- 复用结果 - 探索结果可保存到 memory-bank
核心理念：探索是理解的基础，好的探索策略能显著提升开发效率。
记住: 系统化的代码探索比随机阅读效率高十倍，好的探索策略是高效开发的基础。
Converted and distributed by TomeVault — claim your Tome and manage your conversions.