关于 exploration
exploration 是面向开发者和 Agent 的代码库侦察技能,通过五个阶段按证据分析技术栈、入口点和架构模式。
主要功能
- 01五阶段代码库侦察
- 02映射结构与入口点
- 03分析依赖文件
- 04检测架构模式
- 05生成基于证据的报告
适用场景
- 01了解不熟悉的代码库
- 02准备代码库分析
- 03深入审查前识别架构
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ fusengine/ agents --skill exploration安装后在 Claude Code 中输入/exploration确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/code-organization-checks.mdexploration-protocol.mdquick-analysis-commands.mdresponse-format.mdtech-stack-detection.md详细介绍
探索会运行一个 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