400-frameworks-quarkus-create-project

Quarkus Maven プロジェクトを作成する

SDKMAN で管理されているツールを使って、Java 25 とリポジトリの Quarkus 3.x のベースラインに合わせた、新しい Quarkus Maven プロジェクトを作成します。

このスキルで扱う内容

• プロジェクト作成前に SDKMAN と Java が利用可能か確認する
• SDKMAN を通じて、必要な Java と Quarkus CLI の候補をインストールまたは選択する
• プロジェクトの座標、パッケージ名、Java バージョン、エクステンション、対象ディレクトリを確認する
• Quarkus CLI で Maven プロジェクトを作成する
• 検証には Maven ラッパーコマンドを優先する
• 完了を報告する前に、Maven で生成したプロジェクトを検証する

制約

プロジェクトの作成は、明示的で再現可能な Maven ベースの方法で行う必要があります。

• 前提条件：sdk version で SDKMAN がインストールされていることを確認します。インストールされていない場合は、無断でインストールせずに停止し、セットアップ方法を案内してください
• Java のベースライン：ユーザーが別のサポート対象バージョンを希望しない限り、Java 25 を優先します
• フレームワークのベースライン：デフォルトでは、現行の Quarkus 3.x 系を対象とします
• ビルドツール：Gradle ではなく Maven プロジェクトを生成します
• 安全性：ユーザーから明示的な確認を得ずに、既存の空でない対象ディレクトリを上書きしないでください
• 検証：Maven ラッパーがある場合は、生成したプロジェクトで ./mvnw clean verify を実行します。ない場合は mvn clean verify を実行します
• 実行前：SDKMAN と Quarkus CLI のワークフロー全体について、リファレンスを確認してください

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

• Quarkus Maven プロジェクトを作成する
• SDKMAN で Quarkus プロジェクトをブートストラップする
• 新しい Quarkus サービスを生成する
• Quarkus 3 の Maven プロジェクトを作成する
• Java 25 で Quarkus サービスのひな形を作成する

ワークフロー

1. リファレンスを確認し、プロジェクトの情報を集める

references/400-frameworks-quarkus-create-project.md を確認してから、プロジェクトのディレクトリ、グループ、アーティファクト、パッケージ名、Java バージョン、希望する Quarkus エクステンションを確認します。

2. SDKMAN で管理されているツールを確認する

SDKMAN、Java、Quarkus CLI が利用可能か確認します。使用するバージョンをユーザーに確認してから、候補をインストールまたは切り替えます。

3. Maven プロジェクトを作成する

Quarkus CLI を使用して Maven プロジェクトを作成します。エクステンションを明示し、デフォルトでは Quarkus 3.x のベースラインを維持します。

4. 検証して報告する

生成したプロジェクトで Maven の検証を実行し、使用したコマンド、選択したオプション、生成先のパス、追加で必要なセットアップを要約します。

リファレンス

詳しいガイダンス、例、制約については、references/400-frameworks-quarkus-create-project.md を参照してください。