Spring Data JPA 技能概述
该技能是 Spring Agent Toolkit 的组成部分,用于在 Spring 项目中规范地使用 Spring Data JPA。当任务涉及添加、删除或修改 JPA 实体、仓库或相关代码时,应使用本技能。它以规则与指引的形式,约束实体建模、代码审查与事务处理等环节。
前置条件: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 客户端;完成后 MCP 工具即可用,再继续本技能。若技能列表中没有注册 amplicode-install,则用用户的语言告知:本技能需要 Amplicode IntelliJ 插件及其 MCP 服务器,请从 https://amplicode.ru/marketplace 安装到 IntelliJ IDEA Ultimate/Community 或 GigaIDE,打开任意项目,在 Amplicode 欢迎界面点击「Настроить Spring Agent」,然后重启 MCP 客户端。
处理 JPA 实体
当任务涉及创建或修改 JPA 实体时:若本次对话尚未检测实体约定,先检查记忆中是否保存过约定,若存在则复用,否则阅读 references/entity-conventions.md 并按其全部子步骤检测项目约定。随后阅读 references/entity-rules-impl.md,在编写或修改实体时遵循其中的规则。
审查 JPA 模式
当用户要求审查项目中的 JPA 模式、约定或代码质量时:先按 references/entity-conventions.md(步骤 1.1–1.5)检测当前约定;再将检测到的约定与 references/entity-rules-impl.md 中定义的最佳实践比较。对每个偏差,按如下格式输出建议:
JPA Review
[约定或模式名称]
- Current: <项目当前做法>
- Recommended: <最佳实践建议>
- Reason: <为何重要>
若未发现偏差,则说明项目符合最佳实践。
处理事务
当任务涉及添加或修改事务行为时:若本次对话尚未检测事务约定,先检查记忆中是否保存过约定,若存在则复用,否则阅读 references/transaction-conventions.md 并按其全部子步骤检测项目约定。随后阅读 references/transaction-rules-impl.md,在编写或修改事务代码时遵循其中的规则。
限制与说明
该技能本身不提供独立的收费、价格或平台信息,相关事实暂未提供。其运行依赖 Amplicode IntelliJ 插件与 Spring MCP 服务器;具体可用的 MCP 工具与参考文档内容以其实际提供为准。