api
FreeRESTful API design patterns and best practices. Use when creating endpoints, designing APIs, or implementing routes.
The English summary is being prepared. Showing the original description.
xiaobei930/cc-best48Updated Jun 13, 2026
FreePublished on GitHub
exploration
Code exploration strategies for understanding unfamiliar codebases. Use when exploring unknown code, debugging, or analyzing architecture.
The English summary is being prepared. Showing the original description.
See how to installFiles included (3)
- SKILL.md4.0 KB
- isolated-research.md2.0 KB
- iterative-retrieval.md6.0 KB
SKILL.md (original)
Review the instructions the agent will receive before you install.
代码库探索
本技能提供代码库探索的通用方法论，包含两种策略模式。
子文件
- 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
核心理念：探索是理解的基础，好的探索策略能显著提升开发效率。
记住: 系统化的代码探索比随机阅读效率高十倍，好的探索策略是高效开发的基础。
Reviews
No reviews yet. Tell others what you thought.
Comments
No login needed. Share how it worked for you, ask a question, or note where it did not run.
No comments yet. Be the first to write one.
More skills from this repository
architecture
FreeArchitecture design skill: ADR records, system design checklists, scalability assessment, architecture patterns. Use for complex system design and architecture decisions.
The English summary is being prepared. Showing the original description.
xiaobei930/cc-best48Updated Jun 13, 2026
backend
FreeBackend development patterns for services, error handling, logging, caching. Use when building backend services, APIs, or microservices.
The English summary is being prepared. Showing the original description.
xiaobei930/cc-best48Updated Jun 13, 2026
compact
FreeStrategic compaction skill: suggests context compression at logical breakpoints. Use to suggest compaction at logical intervals during development sessions.
The English summary is being prepared. Showing the original description.
xiaobei930/cc-best48Updated Jun 13, 2026
database
FreeDatabase design, query optimization, migrations, and indexing. Use when designing schemas, writing queries, or managing migrations.
The English summary is being prepared. Showing the original description.
xiaobei930/cc-best48Updated Jun 13, 2026
debug
FreeSystematic debugging methods, log analysis, and performance diagnostics. Use when debugging issues, analyzing errors, or troubleshooting incidents.
The English summary is being prepared. Showing the original description.
xiaobei930/cc-best48Updated Jun 13, 2026