301-frameworks-spring-boot-core

Spring Boot コアガイドライン

アノテーション、Bean 管理、設定、依存性注入に関する Spring Boot コアガイドラインを適用します。

このスキルで扱う内容

• @SpringBootApplication とメインアプリケーションクラス
• コンポーネントアノテーション：@RestController、@Service、@Repository
• Bean の定義、スコープ、ライフサイクル
• 設定クラスと @ConfigurationProperties（起動時に速やかに失敗させるための @Validated を含む）
• コンポーネントスキャンとパッケージ構成
• 条件付き設定とプロファイル（@Profile、@ConditionalOn*）
• コンストラクターによる依存性注入
• 複数の Bean が同じ型を持つ場合のあいまいさを解消する @Primary と @Qualifier
• Bean の最小化と構成
• 処理中のタスクを考慮したグレースフルシャットダウン
• 並行処理がボトルネックとなるワークロードにおいて、対応するスタックでの仮想スレッドの使用
• Jakarta EE の名前空間の一貫性（jakarta.* を優先し、従来の javax.annotation / javax.validation との混在を避ける）
• スケジュールタスクとバックグラウンド処理

適用範囲： 参照ルールと適切・不適切なコード例に基づいて推奨事項を適用します。

制約

Spring Boot に変更を加える前に、プロジェクトがコンパイルできることを確認してください。コンパイルに失敗した場合は、ただちに中止してください。改善を適用した後は、完全な検証を実行してください。

• 必須：変更を加える前に ./mvnw compile または mvn compile を実行してください
• 安全性：コンパイルに失敗した場合は、ただちに中止してください。コンパイル失敗は処理をブロックする条件です
• 検証：改善を適用した後に ./mvnw clean verify または mvn clean verify を実行してください
• 適用前：詳細なルール、適切・不適切なパターン、制約について、参照資料を読んでください
• エッジケース：依頼の範囲が曖昧な場合は、変更を適用する前に中止して確認を求めてください
• エッジケース：必要な入力、ファイル、またはツールが不足している場合は、不足しているものを報告し、セットアップ手順を案内して進めてよいか確認してください

このスキルを使う場面

• Spring Boot アプリケーションの Java コードをレビューする
• Java コードに Spring Boot のベストプラクティスを適用する
• Spring Boot の設定プロパティと Bean を改善する
• Spring Boot のコンポーネントスキャンとプロファイルをレビューする
• Spring Boot のグレースフルシャットダウンまたは仮想スレッドを調整する

ワークフロー

1. 参照資料を読み、プロジェクトの状況を把握する

変更を提案する前に、references/301-frameworks-spring-boot-core.md を読み、現在のプロジェクト設定を確認してください。

2. 範囲を把握し、対象となる改善を決定する

求められている成果、制約、適用する変更のうち安全な最小限の範囲を特定してください。

3. フレームワークに沿った変更を適用する

参照資料のパターンとプロジェクトの規約に従って、設定やコードを実装またはリファクタリングしてください。

4. 検証を実行し、結果を報告する

適切なビルドやテストを実行し、変更内容、検証内容、今後必要な対応をまとめてください。

参照資料

詳細なガイダンス、例、制約については、references/301-frameworks-spring-boot-core.md を参照してください。