501-frameworks-micronaut-core

Micronaut コアガイドライン

DI、設定、HTTP アダプター、運用に関する Micronaut のコアガイドラインを適用します。

このスキルの対象範囲

• Micronaut.run(Application.class, args) を使用した薄い main
• Bean スコープ：@Singleton、@Prototype。リクエストスコープは妥当な理由がある場合のみ
• jakarta.inject.Inject を使用したコンストラクターインジェクション
• サードパーティ製または明示的な Bean の生成に使用する @Factory
• @ConfigurationProperties（設定のグループ化）と、各所に散在する @Property の使い分け
• ドメインコード内で環境分岐を行わず、@Requires と環境を使用
• @Singleton サービスに処理を委譲する、薄い @Controller 型
• 失敗を明確に把握できる @Scheduled
• イベントループをブロックする I/O には、@ExecuteOn(TaskExecutors.BLOCKING)（または仮想スレッドエグゼキューター）を使用
• Netty のグレースフルシャットダウン用プロパティ
• 横断的関心事に対応する AOP インターセプター

スコープ： リファレンスのルールと、良い例・悪い例に基づいて推奨事項を適用します。

制約事項

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

• 必須：変更を適用する前に ./mvnw compile または mvn compile を実行します
• 前提条件：Micronaut コアの改善を適用する前に、プロジェクトが正常にコンパイルできる必要があります
• 安全性：コンパイルに失敗した場合は、直ちに中止してください。コンパイルの失敗は作業を妨げる条件です
• 検証：改善を適用した後に ./mvnw clean verify または mvn clean verify を実行します
• 適用前：詳細なルール、良いパターン・悪いパターン、制約事項についてリファレンスを読みます

このスキルを使用する場面

• Micronaut アプリケーションの構成や Bean について Java コードをレビューする
• Micronaut の設定、@Requires、ファクトリーに関するベストプラクティスを適用する
• Micronaut サービスのスケジューリング、シャットダウン、スレッド処理を改善する
• Micronaut の依存性注入スコープとファクトリーをレビューする
• 環境に応じた Micronaut の @Requires 条件を設定する

ワークフロー

1. リファレンスを読み、プロジェクトの状況を評価する

変更を提案する前に、references/501-frameworks-micronaut-core.md を読み、現在のプロジェクト設定を確認します。

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

求められている成果と制約事項を特定し、安全に適用できる最小限の変更を決定します。

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

リファレンスのパターンとプロジェクトの規約に従って、設定やコードを実装またはリファクタリングします。

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

適切なビルドやテストを実行し、変更内容、検証した項目、追加で必要な対応をまとめます。

リファレンス

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