spring-data-jpa について
spring-data-jpaは、JPAエンティティの作成・変更、JPAパターンのレビュー、トランザクション処理を支援するSpring Agent Toolkitのスキルです。プロジェクトの規約と実装ルールに沿って作業を案内します。
主な機能
- 01JPAエンティティの作成・変更
- 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 の一部であり、(Amplicode IntelliJ プラグインが提供する)Spring MCP server と連携するように設計されています。ほかの作業に進む前に、ツール一覧に Spring MCP ツールがあるか確認してください。これらは amplicode MCP サーバーの下に公開されています(例:get_project_summary、list_module_dependencies、get_entity_details)。MCP ツールをツール一覧にフラット化するハーネスでは、同じ名前の先頭に mcp__amplicode__ が付いています。
- Amplicode ツールが1つ以上使用可能な場合 — 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を読み、トランザクションコードを作成または変更する際は、記載されたルールに従います。