rrezartprebreza/spring-boot-skills

解決する問題

AIコーディングエージェントはSpring Bootでしばしば苦労し、時代遅れのパターンを幻覚したり、プロジェクト固有のアーキテクチャ規約を無視したり、不正確な依存関係バージョンを使用したりします。このプロジェクトは、AIエージェントが一般的または時代遅れのアドバイスではなく、特定の本番グレードのパターンと規約に従うように導く「スキル」—構造化されたMarkdownファイル—のライブラリを提供します。

仕組み

ユーザーは特定のスキルフォルダをAIエージェントの設定ディレクトリ（Claude Codeの.claude/skills/やCodexの.codex/skills/など）に配置します。これらのスキルには、トリガー、規約、および「落とし穴」（一般的なAIの間違いとその修正のリスト）が含まれています。ユーザーがエージェントにタスクを依頼すると、エージェントはリクエストをスキルのトリガーと照合し、関連するガイドラインを読み込んで、生成されたコードがチームのアーキテクチャと標準に一致するようにします。

対象読者

Spring Boot（バージョン3.xまたは4.x）を使用するJava開発者およびアーキテクトで、Claude CodeやCodexなどのAIコーディングエージェントを使用して開発を加速しながら、高品質なコードとアーキテクチャの一貫性を維持したい方。

ハイライト

• バージョン固有のガイダンス：Spring Boot 3と4用に別々のスキルツリーを提供し、最新のフレームワークバージョンとの互換性を確保します。
• コード化された規約：レイヤード/ヘキサゴナルアーキテクチャ、REST API設計、Spring Data JPA、Spring AI統合など、幅広いドメインをカバーします。
• 幻覚防止：各スキルに専用の「落とし穴」セクションを含め、一般的なAIの失敗に基づいてエージェントに何をすべきでないかを明示的に伝えます。
• プラグインサポート：Claude CodeとCodexのマーケットプレイスプラグインとして利用可能で、インストールが簡単です。
• MCP統合：Spring BootアプリをAIエージェントに接続するためのModel Context Protocol (MCP)サーバーの構築に関するガイダンスを提供します。