mcpField
E
exploration

exploration

github.com/fusengine开发3441 次安装2 周前更新
代码仓库

关于 exploration

exploration 是面向开发者和 Agent 的代码库侦察技能,通过五个阶段按证据分析技术栈、入口点和架构模式。

主要功能

  1. 01五阶段代码库侦察
  2. 02映射结构与入口点
  3. 03分析依赖文件
  4. 04检测架构模式
  5. 05生成基于证据的报告

适用场景

  1. 01了解不熟悉的代码库
  2. 02准备代码库分析
  3. 03深入审查前识别架构

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/fusengine/agents --skill exploration

安装后在 Claude Code 中输入/exploration确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
code-organization-checks.md
exploration-protocol.md
quick-analysis-commands.md
response-format.md
tech-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:

  1. 初步侦察 — 列出根目录文件,查找配置文件,检查常见入口点
  2. 结构映射 — 查看目录树(排除干扰目录),识别主要目录
  3. 入口点检测 — 按语言搜索 main/index/服务器引导代码
  4. 依赖分析 — 阅读 package.json/pyproject.toml/go.mod/Cargo.toml/composer.json
  5. 模式检测 — 检查 MVC、Clean/Hexagonal、基于功能的模式,以及 Next.js App Router 目录

架构模式检测

模式指标
模式关键目录指标
MVCcontrollers/、models/、views/Rails、Laravel、Express
Clean Architecturedomain/、application/、infrastructure/DDD、用例
Hexagonaladapters/、ports/、core/端口与适配器
基于功能features/[name]/每个功能包含所有层
分层presentation/、business/、data/传统三层架构
单体单个 src/关注点混杂
微服务多个 services/独立仓库/文件夹
Next.js App Routerapp/、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