SuperAPI AI 工具集

spring-explore

编程与开发

查看项目

更新于 10-15 18:49

技能介绍

spring-explore 是 Spring Agent Toolkit 的一部分,用于探索 Spring Boot 应用并构建项目的主要上下文,涵盖技术栈、模块结构、领域实体和 REST 端点。该技能在收到明确请求时触发。

用途 该技能旨在帮助用户快速理解一个 Spring Boot 项目的整体结构和关键组成部分,为后续的开发、修改或分析任务提供基础上下文。它通过调用 Spring MCP 服务器提供的工具来收集信息,而不是手动搜索文件或浏览项目结构。

前置条件 该技能依赖 Spring MCP 服务器,该服务器由 Amplicode IntelliJ 插件提供。在执行任何操作之前,需要检查工具列表中是否存在任何 Spring MCP 工具。这些工具暴露在 amplicode MCP 服务器下,例如 get_project_summary、list_module_dependencies、get_entity_details;如果工具列表将 MCP 工具扁平化,则使用 mcp__amplicode__ 前缀。如果至少有一个 Amplicode 工具可用,说明 MCP 已连接,可以继续执行技能。如果没有任何可用工具,则停止并调用 amplicode-install 技能(随 Spring Agent Toolkit 捆绑),该技能会安装 Amplicode 插件并引导用户完成「Настроить Spring Agent」欢迎屏幕按钮和 MCP 客户端重启。如果 amplicode-install 未注册在技能列表中,则告知用户需要安装 Amplicode IntelliJ 插件及其 MCP 服务器,从 https://amplicode.ru/marketplace 安装到 IntelliJ IDEA Ultimate/Community 或 GigaIDE,打开任意项目,在 Amplicode 欢迎屏幕上点击「Настроить Spring Agent」,然后重启 MCP 客户端。

主要能力 该技能按步骤 0 至 6 顺序执行,每一步都基于前一步的结果。如果当前对话中已经收集了上下文,则不会重复探索。

步骤 0:根据用户请求预测涉及的内容。不调用任何工具,基于命名约定、领域语言和典型 Spring Boot 模式进行推测,包括实体、仓库、服务、控制器、其他 bean/组件以及非 Java 文件。构建初步的差距列表,仅包含真正需要的内容。

步骤 1:定义探索目标并选择路径。不调用任何工具,根据当前对话上下文制定关键探索目标,并对每个探索路径明确决定包含或跳过,附上一行理由。探索路径包括项目结构(获取项目摘要、检测持久化栈、列出领域实体、列出 REST 端点)、领域模型(获取实体描述、从实体获取深层模型、从实体获取 DDD 模型)、持久化(获取实体仓库、获取实体组件)、服务(获取实体服务)、映射器(获取实体映射器)、DTO(获取实体 DTO)、REST 层(获取实体控制器)。然后生成最终计划。

步骤 2:加载参考文档。不调用任何工具,根据步骤 1 的探索计划,仅加载所选路径所需的参考文档。加载后直接进入步骤 3,不手动搜索文件或探索项目结构。

步骤 3:构建统一探索计划。不调用任何工具,使用步骤 1 选择的路径和加载的参考文档中描述的过程,构建一个统一的编号 MCP 调用计划,每个项目必须是具体的 MCP 工具调用。

步骤 4:通过子代理执行探索计划。生成一个子代理并传递指令,按顺序调用每个 MCP 工具,收集并返回所有结果,不进行总结或截断。对于看起来像凭据的键(如 password、secret、token 等),仅将值替换为 [REDACTED],保留键和周围结构。等待子代理完成并收集所有结果。

步骤 5:构建探索报告。不调用任何工具,仅根据子代理结果进行推理。综合所有发现,生成单一报告,仅包含对任务真正有价值的内容。报告结构包括技术栈、持久化、领域模型、仓库、服务、映射器、DTO、REST API(相关端点)和值得注意的发现。

步骤 5.5:形成隐式假设。不调用任何工具,仅根据子代理结果和用户请求进行推理。识别用户未明确说明但可能期望的内容,包括行为期望、安全/访问控制、验证、错误处理、约定、相关副作用、DTO 形状。输出所有假设以便验证或纠正。如果无法识别任何隐式假设,则明确说明。

步骤 6:决定下一个周期。不调用任何工具,仅根据子代理结果进行推理。预测额外周期的价值(0-100),显示分数和理由。分数大于 80 则返回步骤 1,分数小于等于 80 则停止。

使用方式 该技能通过触发词激活,在收到明确请求时执行。执行时按步骤顺序进行,每一步都会告知用户当前进度(如 Step 0/6: Analyzing request...)。所有项目信息必须通过 MCP 工具获取,不手动搜索文件。

适用场景 适用于需要快速了解 Spring Boot 项目结构、技术栈、领域实体和 REST 端点的场景,特别是在进行开发、修改或分析任务之前,需要建立项目上下文时。

限制 该技能依赖 Amplicode IntelliJ 插件及其 MCP 服务器,如果未安装或未连接,则无法使用。此外,该技能仅通过 MCP 工具获取信息,不进行手动文件搜索。关于收费、价格、平台、效果或使用步骤等具体信息,资料中暂未提供。