用途:在 SDKMAN 管理的工具链下创建新的、基于 Maven 的 Quarkus 3.x 项目,默认对齐 Java 25。适用于新建 Quarkus Maven 项目、用 SDKMAN 引导 Quarkus 项目、生成新的 Quarkus 服务、创建 Quarkus 3 Maven 项目、以 Java 25 脚手架化 Quarkus 服务等场景。
主要能力与流程:先阅读 references/400-frameworks-quarkus-create-project.md,收集项目目录、group、artifact、包名、Java 版本及所需 Quarkus 扩展;用 sdk version 验证 SDKMAN 是否已安装,若缺失应停止并给出安装指导,而不是静默安装;检查 SDKMAN、Java 与 Quarkus CLI 可用性,仅在用户确认目标版本后安装或切换候选;使用 Quarkus CLI 创建 Maven 项目,扩展保持显式、默认采用 Quarkus 3.x 基线;生成后验证并报告所用命令、选定选项、生成路径及后续设置。
验证方式:若生成的 Maven wrapper 存在,运行 ./mvnw clean verify;否则运行 mvn clean verify。
约束与限制:项目创建须显式、可复现且基于 Maven;默认目标为当前 Quarkus 3.x 系列,构建工具为 Maven 而非 Gradle;除非用户明确要求其他受支持版本,否则优先 Java 25;未经用户明确确认,不得覆盖已存在的非空目标目录;应用前需先阅读参考文档了解完整的 SDKMAN 与 Quarkus CLI 工作流。其余版本细节、具体命令示例与扩展选择以参考文档为准。