【Skill 创作】一个能帮你写 Spring Boot 项目全栈代码的技能，覆盖了 40+ 主流框架
一、Skill 简介
这是一个面向 Java 后端开发者的 Spring Boot 全栈开发辅助 Skill。它能根据你的需求，自动生成符合最佳实践的项目代码——从最基础的 Spring Boot、Spring MVC、MyBatis，到 JPA、Druid、Sa-Token、MapStruct、EasyExcel、XXL-Job、Flowable，再到 Redis、MySQL、PostgreSQL、MongoDB、Elasticsearch、ClickHouse、RabbitMQ、Kafka、MQTT、MinIO，以及 Nacos、OpenFeign、Gateway、Sentinel 等微服务组件。支持分布式锁、分布式事务、高并发架构、线程池管理等企业级开发场景。
一句话：你告诉它要做什么，它给你写出能直接运行的代码。
二、使用场景
先说我为什么做这个 Skill。
作为一个经常要搭新项目的人，每次从零开始建 Spring Boot 项目，都要反复做一堆事情，配 pom.xml、写统一响应体、搞异常处理、配 Redis、接消息队列、建线程池……这些东西其实都是有固定套路的，但每次都要重新来一遍，挺耗时的。
而且网上的教程零零散散，找个分布式锁的代码要翻好几个博客，找个 MyBatis-Plus 分页配置又要去官方文档里扒。我就在想，能不能把这些常用的框架和最佳实践都整理到一个 Skill 里，用的时候直接触发，一次性给到完整的方案和代码。
另外就是带新人的时候，经常有人问"Redis 分布式锁怎么写"、“RabbitMQ 怎么配置死信队列”、"XXL-Job 怎么接入"这种问题。与其每次都口头说一遍然后发一堆链接，不如直接让这个 Skill 生成一份完整的、可以直接用的代码，效率会高很多。
具体来说，这个 Skill 适合这些场景：
快速搭项目：输入"springboot项目初始化"，一键生成标准项目结构、依赖配置、分层代码模板。
框架集成：需要接入某个框架时，直接说"Redis配置"、“JPA配置”、“MongoDB集成”、"Elasticsearch集成"等，获得完整的 pom.xml 依赖、yml 配置、配置类代码和使用示例。
中间件接入：RabbitMQ、Kafka、MQTT、MinIO、ClickHouse 等中间件的集成方案，包含生产者和消费者的完整代码。
微服务组件：Nacos 注册/配置中心、OpenFeign 远程调用+降级、Gateway 网关+鉴权，拿到就是完整可用的配置。
企业级功能：分布式锁、分布式事务、高并发限流、线程池管理、幂等性设计、工作流引擎、Excel 导入导出、分布式定时任务等，直接输出最佳实践代码。
技术选型咨询：不清楚该用哪个框架时，它会给出选型建议和对比分析，比如 JPA vs MyBatis-Plus、RabbitMQ vs Kafka、Spring Security vs Sa-Token。
三、创作过程
这个 Skill 的创作思路其实挺直接的，就是把我这些年用过的 Spring Boot 生态框架和中间件，按照一个清晰的结构组织起来，让 Skill 能在需要的时候快速检索到正确的参考资料并生成代码。
核心想法是三层结构：
第一层：Skill 主定义（SKILL.md）
这层解决"什么时候触发"和"按什么流程工作"的问题。
我设置了 40 个触发词，覆盖日常开发中最常见的场景——从"springboot项目初始化"、“MyBatisPlus配置”、“JPA配置"到"分布式锁”、“高并发优化”、“XXL-Job定时任务”、“Flowable工作流”，基本上一说到这些词 Skill 就会自动激活。
工作流程设计为三步：需求理解 → 资料参考 → 方案设计与代码生成。这样保证了 Skill 不是机械地堆代码，而是先理解需求再给出方案。
技术选型部分做了两个表，一个是"技术栈选型表"，按场景分类列出了推荐技术和备选方案；另一个是"技术选型决策指南"，把用户描述、推荐方案和原因一一对应。比如用户说"简单CRUD、快速开发"，Skill 会推荐 MyBatis-Plus 而不是 JPA。
第二层：框架参考文档（framework-docs.md）
这层是 Skill 的知识库，包含了 17 个主流框架的完整资料。
每个框架都按统一的格式组织：官方文档链接、pom.xml 依赖、application.yml 配置、核心代码模板、使用示例。不是泛泛而谈，而是直接给出能复制粘贴使用的代码。
覆盖的框架包括：
- Spring Boot、Spring MVC、Spring Security + JWT、Spring 核心
- MyBatis / MyBatis-Plus
- Spring Data JPA
- Druid 连接池
- Knife4j 接口文档
- Sa-Token 认证鉴权
- Caffeine 本地缓存
- Guava 工具类
- MapStruct 对象映射
- Spring Data MongoDB
- MinIO 对象存储
- 测试框架（Junit + MockMvc）
第三层：中间件与高级开发（middleware-best-practices.md + advanced-development.md）
这两份文档聚焦中间件集成和企业级开发模式。
中间件部分覆盖了 Redis（含分布式锁、缓存穿透/雪崩处理、布隆过滤器）、MySQL、PostgreSQL、多数据源、RabbitMQ（含延迟消息、死信队列）、Kafka、MQTT、Elasticsearch、ClickHouse。
高级开发部分覆盖了分布式事务（Seata + 本地消息表 + RocketMQ）、线程池与异步处理、高并发限流熔断、消息顺序性、幂等性设计、分布式ID、WebSocket、定时任务、微服务组件（Nacos + OpenFeign + Gateway）、XXL-Job、Flowable 工作流、EasyExcel 导入导出。
整个 Skill 的文档总量大约 150 KB，1600+ 行，覆盖 40+ 框架和中间件，每个都有完整的代码示例。
四、使用步骤
-
将
.trae/skills/spring-boot-dev/目录放置到项目的.trae/skills/目录下。 -
在 Trae IDE 的 Agent 对话框中，输入与你的需求相关的触发词即可激活 Skill。比如：
- “springboot项目初始化”——快速搭建新项目
- “Redis配置”——Redis 集成方案
- “分布式锁”——分布式锁实现
- “JPA配置”——JPA 持久层
- “Nacos注册中心”——微服务注册中心
- “EasyExcel导入导出”——Excel 处理
- “Flowable工作流”——审批流程
- “Elasticsearch集成”——搜索引擎集成
-
Skill 会先理解你的需求，必要时主动询问补充信息。
-
然后给出技术方案说明。
-
生成完整的项目结构、pom.xml 依赖、application.yml 配置、各层核心代码。
-
最后给出使用说明和测试建议。
你也可以直接用自然语言描述需求，比如"我需要一个用户管理系统，用 MyBatis-Plus，带 Redis 缓存和 JWT 认证"，Skill 会理解意图并给出完整方案。
五、效果展示
场景一：从零搭建 Spring Boot 项目
输入"springboot项目初始化"，Skill 会输出：
- 完整的 pom.xml（含 Web、Validation、AOP、Lombok、测试等依赖）
- 标准的 application.yml 配置
- 项目目录结构（controller/service/mapper/entity/dto/vo/enums/exception/config）
- 统一响应体 Result 类
- 全局异常处理 GlobalExceptionHandler
- 自定义业务异常 BusinessException
场景二：接入 Redis 分布式锁
输入"Redis配置"或"分布式锁"，Skill 会输出：
- Redis 和 Redisson 的 pom.xml 依赖
- Redis 连接池配置（lettuce）
- RedissonClient 配置类
- RedisUtils 工具类（String/Hash/List/Set 操作）
- 两种分布式锁实现方式（Redisson API + 自定义注解+AOP）
- 缓存穿透/击穿/雪崩的处理方案
- 布隆过滤器配置
场景三：接入微服务
输入"Nacos注册中心"或"微服务架构"，Skill 会输出：
- Nacos Discovery + Config 依赖和配置
- OpenFeign 远程调用接口 + 降级工厂
- Gateway 网关路由配置 + 全局鉴权过滤器
- 服务间的完整通信方案
场景四：Excel 导入导出
输入"EasyExcel导入导出"，Skill 会输出：
- EasyExcel 依赖配置
- Excel 实体定义（@ExcelProperty + @DateTimeFormat）
- 导出服务（单 sheet + 多 sheet）
- 导入服务（分批处理）
- 自定义类型转换器
六、Skill 链接
https://gitee.com/lu-tiezhu/quick-spring-dev.git
包含四个文件：
SKILL.md（约 10 KB）—— Skill 主定义，包含触发词、工作流程、技术选型表framework-docs.md（约 52 KB）—— 17 个框架的完整参考资料和代码模板middleware-best-practices.md（约 37 KB）—— 9 种中间件的最佳集成方案advanced-development.md（约 53 KB）—— 12 种企业级高级开发模式
总计约 150 KB，1600+ 行，覆盖 40+ 框架和中间件。
七、总结与思考
做这个 Skill 的过程中，最大的感受是，Spring Boot 生态真的太大了。光是常用框架就有几十个，每个都有自己的最佳实践和踩坑指南。把这些东西整理到一个 Skill 里，本身就是对自己知识体系的一次梳理。
目前最满意的地方：技术选型决策指南。这部分不是简单地罗列框架，而是告诉 Skill"在什么场景下选什么方案，为什么选它"。比如用户描述"简单CRUD"时推 MyBatis-Plus，描述"领域驱动设计"时推 JPA。这让 Skill 不只是代码生成器，更像是一个有经验的技术顾问。
后续想优化的方向：
- 加入更多 Spring Cloud 组件，比如 Sleuth/Zipkin 链路追踪、Spring Cloud Stream 消息驱动
- 增加前端模板，比如 Vue3 + Element Plus 的前后端完整方案
- 支持代码生成后自动创建文件，而不是只输出代码文本
- 加入更多生产环境的最佳实践，比如优雅停机、健康检查、日志采集等
如果你也在用 Spring Boot 做开发，欢迎试试这个 Skill。不管你是刚入门需要一份标准模板，还是老手需要快速集成某个中间件，它应该都能帮上忙。也欢迎给我提建议，比如觉得少了哪个框架、哪个代码模板需要改进，都可以在评论里说。