关于 exploration
exploration 是面向开发者和 Agent 的代码库勘察技能,用于在深入分析前梳理项目。它按五个阶段检查代码,并生成技术栈、入口点和架构模式报告。
主要功能
- 01五阶段代码库勘察
- 02映射项目结构与入口点
- 03分析依赖清单
- 04检测架构模式
- 05生成基于证据的结构化报告
适用场景
- 01实现前了解陌生代码库
- 02为深入分析准备代码库背景
- 03根据项目文件识别架构模式
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ fusengine/ claude-plugins --skill exploration安装后在 Claude Code 中输入/exploration确认已加载。
详细介绍
探索会运行一个 5 阶段的侦察协议,以快速了解代码库:初步侦察(根目录文件、配置、入口点)、结构映射、按语言检测入口点、依赖分析(package.json/pyproject.toml/go.mod/Cargo.toml/composer.json),以及架构模式检测(MVC、Clean、Hexagonal、基于功能、分层、模块化单体、Next.js App Router 等)。
整个过程仅基于证据——没有代码佐证就不做假设——并会生成一份结构化报告,说明技术栈、入口点和检测到的架构模式,供使用者参考(通常是 APEX Analyze 阶段或领域专家)。
会话: ${CLAUDE_SESSION_ID}
探索技能
探索协议
按顺序运行以下 5 个阶段——完整命令见 references/exploration-protocol.md:
- 初步侦察 — 列出根目录文件,查找配置文件,检查常见入口点
- 结构映射 — 查看目录树(排除干扰目录),识别主要目录
- 入口点检测 — 按语言搜索
main/index/服务器引导代码 - 依赖分析 — 阅读
package.json/pyproject.toml/go.mod/Cargo.toml/composer.json - 模式检测 — 检查 MVC、Clean/Hexagonal、基于功能的模式,以及 Next.js App Router 目录
架构模式检测
模式指标
| 模式 | 关键目录 | 指标 |
|---|---|---|
| MVC | controllers/、models/、views/ | Rails、Laravel、Express |
| Clean Architecture | domain/、application/、infrastructure/ | DDD、用例 |
| Hexagonal | adapters/、ports/、core/ | 端口与适配器 |
| 基于功能 | features/[name]/ | 每个功能包含所有层 |
| 分层 | presentation/、business/、data/ | 传统三层架构 |
| 单体 | 单个 src/ | 关注点混杂 |
| 微服务 | 多个 services/ | 独立仓库/文件夹 |
| Next.js App Router | app/、components/、lib/ | 服务端/客户端组件 |
| 模块化单体 | modules/[name]/ | 有界上下文 |
禁止行为
- ❌ 在没有代码证据的情况下做出假设
- ❌ 忽略配置文件
- ❌ 忽视测试目录
- ❌ 跳过依赖分析
- ❌ 遗漏入口点
- ❌ 未经验证就假定架构
行为特征
- 系统且有条理
- 专注于模式检测
- 分析时结合上下文
- 全面且简洁
- 基于证据得出见解
- 深入分析前快速侦察
详细参考资料(按需加载)
references/exploration-protocol.md— 运行 5 阶段协议时加载(每个阶段的精确 shell 命令)references/tech-stack-detection.md— 识别各语言的框架/ORM/工具时加载(JS/TS、Python、Go、PHP、Rust)references/code-organization-checks.md— 审查接口分离、业务逻辑位置或状态管理时加载references/response-format.md— 编写最终探索报告时加载references/quick-analysis-commands.md— 进行一行式全栈评估、文件计数或大文件检测时加载
评论
支持 Markdown