Spring Boot 项目初始化助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_a36dc51e/spring-boot-init。
技能介绍
新建 Spring Boot 项目最磨人的往往不是业务本身,而是在空目录里一步步配 pom.xml、建包结构、写主启动类。这类脚手架搭一次很熟,第二次依然容易踩坑:插件版本散落在各模块、父工程的 module 列表和实际目录对不上、写错一个 groupId 后到处返工。Spring Boot 项目初始化 针对的就是这段「从零到能编译」的重复劳动。
它如何生成骨架
核心不是让 Agent 现场手写文件,而是执行仓库内的 scripts/init.mjs 脚本。脚本基于内置的 Maven 父子标准模板,在本地完成复制、占位符替换、包目录迁移与模块塑形,全链路零网络依赖,离线也能出项目。
- 模块形态:单模块项目使用
--single,聚合根下只保留一个可执行的 app 子模块;多模块项目拆成库模块 + 可执行模块(--core/--app命名)。模块数量与命名由业务形态决定,没有预设common/web这类固定分法。 - 默认质量门禁:模板里
enforcer(环境门禁)、flatten(CI-friendly 版本号)、jacoco(覆盖率)、spotless(格式化)默认激活;failsafe集成测试、source/javadoc等发布类插件已纳入管理,勾选后才会在模块里声明。所有插件版本收敛在根pluginManagement,依赖版本统一走根dependencyManagement的 BOM import,子模块不写版本号。
生成前有一个绕不开的问询环节:init.mjs 的 --group / --artifact / --boot / --jkd 参数不会静默取默认,工具会把工程坐标、模块划分、Boot/JDK 版本、初始依赖、可选插件(即 C1~C4)合并成一轮问题,拿到逐项答复或一句「按推荐」后才执行。依赖也不会默认往里堆,初始 starter 列按项目类型(Web API / 全栈 / 定时批处理 / 消息 / 数据访问)从组合表里选。
适用边界与注意点
这套技能只为一件事而生:把空目录变成一份能编译的结构。它不会替代写入 Controller / Service / 事务逻辑的 spring-boot-dev,也不处理 ORM CRUD 或认证鉴权——工具本身也内置了明确的不适用判定,发现是存量工程加模块、写业务代码或跑单测,会直接建议切换。另外,当前版本只覆盖 Maven,Gradle 项目不适用。
版本组合有一张显式兼容表:Boot 3.5.x 默认跟 JDK 17 / 21(推荐 JDK 21),Boot 4.x 优先 JDK 25、最低 17,2.7.x 仅为存量维护保留。选错版本之间的组合(比如 Boot 4.x 配 JDK 11)是常见翻车点,工具用强约束拦掉了。生成完成后的自检由 scripts/self-check.mjs 负责,会跑 mvn -q validate,检查点包括 {{...}} 占位符零残留、com.example 包路径零残留、模块目录与根 <modules> 一一对应、可执行模块包含主启动类、package 声明与目录层级一致。任何一项不通过即退出码非零,保证交付的骨架不存在「看起来能编译但包名还没改」的半成品状态。
一句话总结:创建 Spring Boot 工程这类高频但枯燥的任务,值得交给脚本兜底约束;系统架构中每一处结构性的基础决策,都需要明确的验证步骤和清晰的边界来守护。
使用场景
- {'text': '调取,从模板生成带 enforcer、jacoco、flatten 的靠谱工程骨架'}
- {'text': '从 assets/maven-multimodule 模板初始化起 Spring Boot 子模块集合'}
- {'text': '用脚本一键产出 composer.json 等结构,Boot/JDK 版本先于悦差'}
- {'text': '在 §0 空目录探测后驱动本地自检,零网络依赖完成骨架交付'}
适合人员
- {'text': 'Java/后端工程师:需要快速交付一定要联调的 Spring Boot 微服务第一个骨架'}
- {'text': 'Maven 项目 owner:希望一份子模块共享父级依赖管理,又不想每次手写版本对齐的架构师'}
- {'text': '从第 0 步就参与模块规划的技术负责人,关注 Boot/JDK 合规与插件生命周期'}
- {'text': '强迫 agent 走生成的提示词作者/Agent 工程师:擅长把 init.mjs 步骤固化进自动化交付链'}