探索是一项面向陌生代码库的快速调研技能,要求分析者按固定顺序执行五个阶段,并以代码证据为依据输出结构化报告,不凭主观假设下结论。
用途:在接手或深入一个不熟悉的代码库之前,先完成系统化的侦察与结构梳理,形成可供后续分析阶段或领域专家使用的事实基础。
主要能力:
- 初步侦察:列出根目录文件、查找配置文件、检查常见入口点。
- 结构映射:以树状视图呈现目录结构(排除噪音目录),识别主要目录。
- 入口点检测:按语言检索 main、index、server 等启动入口。
- 依赖分析:读取 package.json、pyproject.toml、go.mod、Cargo.toml、composer.json 等依赖清单。
- 模式检测:识别 MVC、Clean/Hexagonal、按功能划分、Next.js App Router 等目录特征,并据此判断架构模式。
架构模式识别参考:MVC 对应 controllers/、models/、views/;Clean Architecture 对应 domain/、application/、infrastructure/;Hexagonal 对应 adapters/、ports/、core/;Feature-based 对应 features/[name]/;Layered 对应 presentation/、business/、data/;Monolith 为单一 src/;Microservices 为多个 services/;Next.js App Router 对应 app/、components/、lib/;Modular Monolith 对应 modules/[name]/。
使用方式:按上述五阶段顺序执行,具体命令见 references/exploration-protocol.md;技术栈识别、代码组织检查、报告格式和快速分析命令分别参考对应文档,按需加载。会话标识为 ${CLAUDE_SESSION_ID}。
适用场景:初次接触陌生项目、需要快速了解技术栈与入口、判断架构模式、梳理依赖关系,或在深入分析前做快速侦察。
限制与禁止行为:不得在无代码证据时做假设;不得忽略配置文件;不得跳过测试目录;不得省略依赖分析;不得遗漏入口点;不得在未经验证的情况下断言架构。