本文へ移動
cccskills
無料GitHub で公開

exploration

Code exploration strategies for understanding unfamiliar codebases. Use when exploring unknown code, debugging, or analyzing architecture.

インストール方法を見る

含まれるファイル(3)

  • SKILL.md4.0 KB
  • isolated-research.md2.0 KB
  • iterative-retrieval.md6.0 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

代码库探索

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

子文件

策略选择

场景推荐策略原因
快速了解某个模块isolated-research一次性探索,不污染上下文
理解复杂的跨模块流程iterative-retrieval需要多轮精炼
简单的文件/函数定位直接 Grep/Glob无需完整探索流程
新项目初始理解iterative-retrieval需要建立全局认知
调试特定 Bugisolated-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

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

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

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

api

無料

RESTful API design patterns and best practices. Use when creating endpoints, designing APIs, or implementing routes.

日本語の概要は準備中です。原文の説明を表示しています。

xiaobei930/cc-best482026年6月13日 更新

Architecture design skill: ADR records, system design checklists, scalability assessment, architecture patterns. Use for complex system design and architecture decisions.

日本語の概要は準備中です。原文の説明を表示しています。

xiaobei930/cc-best482026年6月13日 更新

backend

無料

Backend development patterns for services, error handling, logging, caching. Use when building backend services, APIs, or microservices.

日本語の概要は準備中です。原文の説明を表示しています。

xiaobei930/cc-best482026年6月13日 更新

compact

無料

Strategic compaction skill: suggests context compression at logical breakpoints. Use to suggest compaction at logical intervals during development sessions.

日本語の概要は準備中です。原文の説明を表示しています。

xiaobei930/cc-best482026年6月13日 更新

database

無料

Database design, query optimization, migrations, and indexing. Use when designing schemas, writing queries, or managing migrations.

日本語の概要は準備中です。原文の説明を表示しています。

xiaobei930/cc-best482026年6月13日 更新

debug

無料

Systematic debugging methods, log analysis, and performance diagnostics. Use when debugging issues, analyzing errors, or troubleshooting incidents.

日本語の概要は準備中です。原文の説明を表示しています。

xiaobei930/cc-best482026年6月13日 更新

xiaobei930 のスキルをすべて見る

このスキルの問題を報告する