用途
code-explore 是一个纯 Claude 代码调查技能，用于快速理解代码库中的功能实现、追踪执行路径与数据流、诊断问题根因。它强调单视角快速调查，不进行 Codex 交叉验证。
主要能力
- 快速理解某个功能是如何工作的
- 追踪执行路径与数据流
- 诊断问题的根本原因
- 无需双重确认（不进行 Codex 交叉验证）
使用方式
触发关键词包括：code explore、code investigation、research code、trace code、feature understanding、quick investigation、code exploration。
工作流程分为四个阶段：
- 定位入口点：通过 Grep 关键词找到相关文件，识别入口点（Controller / Service / Provider），构建文件列表。
- 追踪路径：从入口点开始读取代码，识别依赖并继续追踪，绘制调用链（A -> B -> C）。
- 理解逻辑：分析核心逻辑是什么、数据如何流动、错误处理机制、关键决策点。
- 输出报告：包含架构概览（图或表）、关键文件列表、执行流程、发现与备注。
搜索策略示例：功能入口使用 Grep "export class.Controller" 或 Grep "@Get|@Post"；Service 层使用 Grep "export class.Service"；Provider 层使用 Glob "src/provider/**/.ts"；配置读取 {CONFIG_FILE}；数据模型使用 Glob "src/model/**/.ts"。
输出格式包含：调查主题、架构概览（ASCII 或 Mermaid 图）、关键文件表（文件与职责）、执行流程步骤、数据流描述、发现、备注（潜在问题或边界情况）。
验证清单：入口点已识别并列出；执行流程已端到端追踪；关键文件表包含所有相关文件；发现部分包含可操作的见解。
参考资料：references/search-patterns.md，用于构建搜索策略时阅读。
适用场景
- 功能理解：例如调查用户数据查询如何工作，从 Grep "balance" 找到 UserService、UserController，追踪 Controller -> Service -> Provider 调用链，理解查询与缓存机制，输出报告与流程图。
- 问题诊断：例如排查某 API 为何有时返回空，从 Grep "getData" 与 "cache" 找到相关文件，追踪数据获取路径，识别回退逻辑与超时处理，列出可能原因与建议。
- 架构理解：例如了解用户模块的整体架构，通过 Glob "src/**/user" 列出所有相关文件，识别层间关系（Controller -> Service -> Provider），理解各层职责，输出架构图与模块说明。
限制
- 仅提供单一视角，不进行交叉验证。
- 不适用于需要双重确认的场景，应改用 /code-investigate（Claude + Codex）。
- 不适用于 Git 历史追踪，应改用 /git-investigate。
- 不适用于系统验证，应改用 /feature-verify。
- 不适用于代码审查，应改用 /codex-review-fast。
- 与 code-investigate 的差异：code-explore 速度快（单视角）、单视角确认、纯 Claude 工具，适合快速调查；code-investigate 速度慢（双视角）、交叉验证、Claude + Codex，适合重要决策。