Spring Boot Skills 全景指南（重编版）
一、为什么需要 Skills？
AI 编码工具（Claude Code、Cursor、Copilot CLI 等）在 Spring Boot 项目中最常见的痛点是：生成的代码缺乏 Spring 工程经验——比如滥用字段注入、不分层、没有全局异常处理、测试覆盖率低。
Skills 的出现就是为了解决这个问题：把资深 Spring 工程师的编码规范、架构模式、测试策略打包成 AI 可以直接加载的结构化知识包，让 AI 像老手一样写代码。
一个标准的 Skill 目录结构如下：
.claude/skills/<skill-name>/
├── SKILL.md # 触发条件 + 核心规则（≤500 token）
├── conventions.md # 详细约定
├── examples/ # 正反例代码
├── templates/ # 可复用的代码模板
└── references/ # 按需加载的补充文档二、五大专用 Spring Boot Skills 项目
| 项目 | 一句话定位 | 核心价值 |
|---|---|---|
| Dr JSkill（⭐251） | JHipster 创始人出品，项目脚手架生成 | 按业界最严规范一键生成 Spring Boot 4.x + Java 25 + PostgreSQL + Docker 项目，可选 Vue/React/Angular 前端 |
| spring-boot-skills（rrezartprebreza） | 生产级日常开发规范集合 | 每个 Skill = 约定 + 示例 + 模板，AI 可直接复制正确代码，涵盖 REST API、测试、DB 迁移等 |
| springboot-skills-marketplace（⭐47） | 渐进式架构模式库 | 从 Layered → Package-by-Module → Modular Monolith → DDD+Hexagonal，按项目复杂度逐步升级，防止过度设计 |
| Spring Boot Engineer Subagent | 高级 Spring Boot 编码专家角色 | 独立 subagent，负责实现：88%+ 测试覆盖、2.3s 启动、GraalVM Native 优化 |
| Java Architect Subagent | 企业级架构决策角色 | 在架构分析阶段调用，把关技术选型和分层设计合理性 |
三、大型 Skills 集合中的 Spring Boot 相关条目
3.1 Antigravity Awesome Skills（⭐38.9k，1,480+ Skills）
安装：npx antigravity-awesome-skills --claude
与 Spring Boot 直接相关的 15 个精华 Skill：
| Skill 名称 | 说明 | 适用场景 |
|---|---|---|
| java-architect | 企业级 Java 架构师 | 系统架构设计、技术选型 |
| spring-boot-engineer | Spring Boot 3+ 专家 | 日常开发、微服务实现 |
| api-design-principles | REST/GraphQL API 设计原则 | API 接口设计 |
| database-optimization | 数据库优化 | 查询调优、索引策略 |
| tdd-mastery | Red-Green-Refactor 测试驱动开发 | 测试编写 |
| security-hardening | 安全加固 | 输入验证、认证模式 |
| code-refactoring-refactor-clean | 重构专家 | 代码清理、SOLID 原则 |
| production-code-audit | 生产级代码审计 | 上线前审查 |
| cqrs-implementation | CQRS 架构实现 | 读写分离架构 |
| ddd-strategic-design | DDD 战略设计 | 限界上下文划分 |
| ddd-tactical-patterns | DDD 战术模式 | 聚合、值对象、领域事件 |
| event-sourcing-architect | 事件溯源架构 | 事件驱动系统 |
| postgres-best-practices | PostgreSQL 最佳实践 | 数据库设计 |
| sql-optimization-patterns | SQL 优化模式 | 慢查询优化 |
| monorepo-architect | 单仓库架构 | 大型多模块 Spring 项目 |
3.2 VoltAgent Awesome Agent Skills（⭐23.3k，1,000+ Skills）
安装：git clone 后手动配置 skills 目录
与 Antigravity 类似，Java 相关 Skills 分类在 02-language-specialists/ 目录下，包含 Spring Boot Engineer 和 Java Architect 等角色 Subagent。
3.3 Awesome Claude Code Toolkit（⭐1.8k）
安装：克隆后手动配置 skills 目录
包含 135 agents + 35 curated skills + 42 commands + 176+ plugins。Spring Boot 相关的 Skills 分布在 API Design、Database Optimization、TDD、Security 等目录下。
四、Spring AI 原生集成（最有前景的方向）
Spring AI 社区已将 Skills 概念引入 Spring 生态，允许 在 Spring Boot 应用内部运行 AI Agent 并加载 Skills。
4.1 spring-ai-agent-utils（⭐460）
- 功能：将 Claude Code 的 Skills 概念作为 Spring AI 工具重新实现
- SkillsJar：可将 Skills 打包为 Maven/Gradle 依赖，在团队间分发
- 集成方式：通过
SkillsTool在ChatClient中注册 Skills - 代码示例：
ChatClient chatClient = chatClientBuilder .defaultToolCallbacks(SkillsTool.builder() .addSkillsDirectory(".claude/skills") .build()) .defaultTools(FileSystemTools.builder().build()) .defaultTools(ShellTools.builder().build()) .build();
4.2 官方示例：在 Spring Boot 中创建 Code Reviewer Skill
Spring 官方博客展示了如何定义和加载一个代码审查 Skill：
mkdir -p .claude/skills/code-reviewer
cat > .claude/skills/code-reviewer/SKILL.md << 'EOF'
---
name: code-reviewer
description: Reviews Java code for best practices, security issues, and Spring Framework conventions.
Use when user asks to review, analyze, or audit code.
---
# Code Reviewer
## Instructions
When reviewing code:
1. Check for security vulnerabilities (SQL injection, XSS, etc.)
2. Verify Spring Boot best practices (proper use of @Service, @Repository, etc.)
3. Look for potential null pointer exceptions
4. Suggest improvements for readability and maintainability
5. Provide specific line-by-line feedback with code examples
EOF五、如何为 Spring Boot 项目编写自己的 Skill
5.1 创建步骤
# 1. 创建 skill 目录
mkdir -p .claude/skills/spring-boot-rest-api
# 2. 创建 SKILL.md
cat > .claude/skills/spring-boot-rest-api/SKILL.md << 'EOF'
---
name: spring-boot-rest-api
description: 编写 Spring Boot REST API 的最佳实践。当用户要求创建 Controller、DTO 或 REST 端点时自动激活。
---
# Spring Boot REST API 开发指南
## 触发条件
- 创建新的 REST Controller
- 编写 DTO / VO 类
- 设计 API 响应格式
## 核心规则
1. 使用 @RestController + @RequestMapping
2. 所有响应统一包装为 Result<T> 格式
3. 使用 @Valid 进行请求参数校验
4. 全局异常处理使用 @ControllerAdvice
5. 分页查询使用 Pageable 参数
## 代码示例
（见 references/ 目录）
EOF
# 3. 创建参考文件
mkdir -p .claude/skills/spring-boot-rest-api/references5.2 编写最佳实践
| 原则 | 说明 |
|---|---|
| 控制体量 | SKILL.md 控制在 500 token 以内，超出部分放入 references/ 目录按需加载 |
| 明确触发 | 触发条件用“当用户要求…时”的句式 |
| 正反对比 | 包含正反例对比，帮助 Agent 理解“什么是好的代码” |
| 模板复用 | 使用模板文件，放在 templates/ 目录供 Agent 复制使用 |
| 团队共享 | 提交到版本控制，让团队共享 |
六、Spring Boot 项目 CLAUDE.md 模板
CLAUDE.md 是每次对话都加载的项目级上下文，配合 Skills 使用效果最佳。
# 项目名称
## 技术栈
- Spring Boot 4.x / Java 25
- PostgreSQL + JPA/Hibernate
- Spring Security + JWT
- Redis 缓存
- Docker + Kubernetes
## 关键命令
- `./mvnw spring-boot:run` — 启动开发服务器
- `./mvnw test` — 运行测试
- `./mvnw clean package -DskipTests` — 打包
## 代码规范
- 构造器注入（不用 @Autowired 字段注入）
- Service 层不加 @Transactional（只在需要的方法上加）
- Entity 不直接暴露给 API（用 DTO 转换）
- 日志用 SLF4J，不用 System.out
## Skills
本项目已安装以下 Skills：
- spring-boot-rest-api：REST API 开发
- spring-boot-testing：测试编写
- code-reviewer：代码审查七、推荐的 Spring Boot + Agent Skills 工作流
7.1 标准工作流
- 探索阶段：让 Agent 读取代码库，理解架构
- 规划阶段：使用
/plan模式，Agent 输出实现方案 - 编码阶段：Agent 按规划逐步实现（自动加载匹配的 Skills）
- 验证阶段：运行测试，确认通过
- 提交阶段：Git commit + push
7.2 多 Agent 协作模式
对于复杂 Spring Boot 项目，可以按角色分配不同 Skills：
| Agent 角色 | 职责 | 推荐 Skill |
|---|---|---|
| 架构师 | 设计微服务架构、模块拆分 | Java Architect |
| 开发者 | 编写具体代码 | Spring Boot Engineer / Dr JSkill |
| 测试工程师 | 编写和运行测试 | TDD Mastery |
| 安全审计 | 安全漏洞扫描 | Security Hardening |
| 代码审查 | 代码质量把关 | Code Reviewer |
八、总结
本文系统梳理了 AI Coding Agent 在 Spring Boot 项目中的 Skills 生态。核心思路是：将高级 Spring 工程师的经验固化为 AI 可加载的结构化知识包，从而让 AI 生成的代码符合行业规范，减少幻觉。
无论你是想快速搭建脚手架（Dr JSkill）、制定团队编码规范（spring-boot-skills）、渐进式演进架构（springboot-skills-marketplace），还是想在 Spring Boot 应用内部集成 AI Agent（spring-ai-agent-utils），都能在这篇文章中找到对应的解决方案。
下一步行动建议：
- 为你的 Spring Boot 项目创建一个
CLAUDE.md文件 - 从 Antigravity 或 VoltAgent 集合中选择 3~5 个核心 Skills 安装
- 根据团队规范编写 1~2 个自定义 Skill
- 尝试多 Agent 协作模式，提升开发效率
