关于 spring-data-jpa
spring-data-jpa 是 Spring Agent Toolkit 中用于创建或修改 JPA 实体、审查 JPA 模式及处理事务行为的技能。它依据项目约定和实现规则指导操作。
主要功能
- 01创建或修改 JPA 实体
- 02检测并沿用实体约定
- 03依据最佳实践审查 JPA 模式
- 04应用事务约定和规则
适用场景
- 01在现有项目中实现 JPA 实体
- 02审查实体模式与代码质量
- 03添加或修改事务行为
MCP 相关
需要由 Amplicode IntelliJ 插件提供的 Spring MCP 服务;执行前会检查是否有可用的 Amplicode 工具。
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ amplicode/ spring-skills --skill spring-data-jpa安装后在 Claude Code 中输入/spring-data-jpa确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/entity-conventions.mdentity-rules-impl.mdrepository-conventions.mdtransaction-conventions.mdtransaction-oregination.mdtransaction-rules-impl.md详细介绍
预检:Spring MCP
此技能是 Spring Agent Toolkit 的一部分,旨在与 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
**[Convention or pattern name]**
- Current: <what the project does>
- Recommended: <what the best practice says>
- Reason: <why this matters>
如果没有发现偏差,则说明项目符合最佳实践。
使用事务
当任务涉及添加或修改事务行为时:
- 如果本次对话中尚未检测事务约定,请先检查记忆中是否保存了此前的约定。如果找到,请沿用。否则,读取
references/transaction-conventions.md,并按照其中的所有子步骤检测项目约定。 - 编写或修改事务代码时,读取
references/transaction-rules-impl.md并遵循其中的规则
评论
支持 Markdown