Spring Boot Patterns Skill 是 Everything Claude Code 插件体系中专为 Java/Spring Boot 后端开发打造的模式库，涵盖分层架构、REST API 设计、数据访问（JPA）、缓存、异步处理、异常与日志管理等一站式生产级实践。通过激活该 Skill，AI 编程助手能够自动输出结构化、高质量的 Spring Boot 代码骨架和关键实现，极大提升团队协作、可维护性和开发效率，特别适合需要标准化后端的企业级项目。

Everything Claude Code Spring Boot Patterns Skill：分层架构、REST API、数据访问、缓存与异步处理

Spring Boot Patterns Skill 是 Everything Claude Code 插件体系中专为 Java/Spring Boot 后端开发场景设计的专业 Skill。它不仅内置了分层架构、RESTful API、数据访问、缓存、异步处理、日志与异常管理等最佳实践，还能在 Claude Code、Codex、Cursor 等 AI 编程助手环境下自动输出标准化代码和配置建议。相比手动查找文档、零散复制代码片段，激活此 Skill 后，AI 将根据上下文自动生成高质量、可扩展的 Spring Boot 代码骨架与实现细节，显著提升开发效率与代码一致性。

想了解 Everything Claude Code 的整体架构和 Skill/Agent 体系，请参考 Everything Claude Code 完全指南。

适用场景与触发条件

Spring Boot Patterns Skill 适用于以下典型场景：

• 新建或重构 Spring Boot 后端项目时，需要标准分层架构（Controller → Service → Repository）
• 设计和实现 RESTful API，包括参数校验、分页、异常处理等
• 集成 Spring Data JPA 进行数据访问，规范 Repository 层写法
• 配置和使用缓存（如 @Cacheable/@CacheEvict）、异步处理（@Async）、定时任务等
• 需要统一日志、监控、限流（如 Bucket4j）、安全实践
• 需要为不同环境（开发/测试/生产）配置 profile
• 实现事件驱动（如 Spring Events、Kafka）等高级模式

Skill 会在你通过 Claude Code/AI 助手提出相关需求或项目结构分析时自动激活。例如：

• “帮我生成一个标准的 Spring Boot REST API 控制器和服务层”
• “如何在 Spring Boot 中实现分页、缓存和异步通知？”
• “请给出生产级别的异常处理和日志方案”

Step by Step 操作指南

1. 激活 Skill 并指定目标

在 Claude Code/Cursor/其他支持 ECC 的 AI 编程助手中，确保 springboot-patterns Skill 已安装（可通过 安装配置指南 选择性启用）。在对话中提出类似：

“使用 Spring Boot Patterns Skill，帮我设计一个 Market 管理模块，包含 REST API、分页、JPA 数据访问、缓存和异步通知。”

AI 会自动识别并应用本 Skill 的所有最佳实践模板。

---

2. 生成标准分层架构骨架

Skill 会输出如下分层结构：

• Controller（API 层，负责参数校验、响应封装）
• Service（业务逻辑层，处理事务、聚合、异步等）
• Repository（数据访问层，基于 Spring Data JPA）

示例：MarketController

@RestController
@RequestMapping("/api/markets")
@Validated
class MarketController {
  private final MarketService marketService;

  MarketController(MarketService marketService) {
    this.marketService = marketService;
  }

  @GetMapping
  ResponseEntity<Page<MarketResponse>> list(
      @RequestParam(defaultValue = "0") int page,
      @RequestParam(defaultValue = "20") int size) {
    Page<Market> markets = marketService.list(PageRequest.of(page, size));
    return ResponseEntity.ok(markets.map(MarketResponse::from));
  }

  @PostMapping
  ResponseEntity<MarketResponse> create(@Valid @RequestBody CreateMarketRequest request) {
    Market market = marketService.create(request);
    return ResponseEntity.status(HttpStatus.CREATED).body(MarketResponse.from(market));
  }
}

---

3. 生成 Repository 模式的数据访问层

Skill 会建议使用标准的 Spring Data JPA Repository 接口，自动补全常见查询与排序方法。

public interface MarketRepository extends JpaRepository<MarketEntity, Long> {
  @Query("select m from MarketEntity m where m.status = :status order by m.volume desc")
  List<MarketEntity> findActive(@Param("status") MarketStatus status, Pageable pageable);
}

---

4. Service 层事务与业务逻辑

Skill 自动生成带事务注解的 Service 层，并建议将查询和变更操作分离（如 @Transactional(readOnly = true)）。

@Service
public class MarketService {
  private final MarketRepository repo;

  public MarketService(MarketRepository repo) {
    this.repo = repo;
  }

  @Transactional
  public Market create(CreateMarketRequest request) {
    MarketEntity entity = MarketEntity.from(request);
    MarketEntity saved = repo.save(entity);
    return Market.from(saved);
  }
}

---

5. DTO、参数校验与响应模型

Skill 会自动生成带注解的 DTO，并推荐使用 @Validated、@Valid、@NotBlank、@Size 等参数校验。

public record CreateMarketRequest(
    @NotBlank @Size(max = 200) String name,
    @NotBlank @Size(max = 2000) String description,
    @NotNull @FutureOrPresent Instant endDate,
    @NotEmpty List<@NotBlank String> categories) {}

public record MarketResponse(Long id, String name, MarketStatus status) {
  static MarketResponse from(Market market) {
    return new MarketResponse(market.id(), market.name(), market.status());
  }
}

---

6. 统一异常处理

Skill 自动输出全局异常处理器，集中处理参数校验、权限、未知异常，保证 API 返回一致。

@ControllerAdvice
class GlobalExceptionHandler {
  @ExceptionHandler(MethodArgumentNotValidException.class)
  ResponseEntity<ApiError> handleValidation(MethodArgumentNotValidException ex) {
    String message = ex.getBindingResult().getFieldErrors().stream()
        .map(e -> e.getField() + ": " + e.getDefaultMessage())
        .collect(Collectors.joining(", "));
    return ResponseEntity.badRequest().body(ApiError.validation(message));
  }

  @ExceptionHandler(AccessDeniedException.class)
  ResponseEntity<ApiError> handleAccessDenied() {
    return ResponseEntity.status(HttpStatus.FORBIDDEN).body(ApiError.of("Forbidden"));
  }

  @ExceptionHandler(Exception.class)
  ResponseEntity<ApiError> handleGeneric(Exception ex) {
    // Log unexpected errors with stack traces
    return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR)
        .body(ApiError.of("Internal server error"));
  }
}

---

7. 缓存与异步处理

Skill 自动补全缓存与异步模式，包括 @EnableCaching、@Cacheable、@CacheEvict、@EnableAsync、@Async 等。

缓存示例：

@Service
public class MarketCacheService {
  private final MarketRepository repo;

  public MarketCacheService(MarketRepository repo) {
    this.repo = repo;
  }

  @Cacheable(value = "market", key = "#id")
  public Market getById(Long id) {
    return repo.findById(id)
        .map(Market::from)
        .orElseThrow(() -> new EntityNotFoundException("Market not found"));
  }

  @CacheEvict(value = "market", key = "#id")
  public void evict(Long id) {}
}

异步通知示例：

@Service
public class NotificationService {
  @Async
  public CompletableFuture<Void> sendAsync(Notification notification) {
    // send email/SMS
    return CompletableFuture.completedFuture(null);
  }
}

---

8. 日志、监控与限流

Skill 推荐使用 SLF4J/Logback 结构化日志、Micrometer 指标、Prometheus/OTel 监控，并自动生成限流 Filter（如 Bucket4j），并给出安全配置说明。

请求日志 Filter 示例：

@Component
public class RequestLoggingFilter extends OncePerRequestFilter {
  private static final Logger log = LoggerFactory.getLogger(RequestLoggingFilter.class);

  @Override
  protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response,
      FilterChain filterChain) throws ServletException, IOException {
    long start = System.currentTimeMillis();
    try {
      filterChain.doFilter(request, response);
    } finally {
      long duration = System.currentTimeMillis() - start;
      log.info("req method={} uri={} status={} durationMs={}",
          request.getMethod(), request.getRequestURI(), response.getStatus(), duration);
    }
  }
}

限流安全注意事项：

• 永远不要直接信任 X-Forwarded-For，除非已配置受信代理与 ForwardedHeaderFilter
• 推荐配置 server.forward-headers-strategy，并确保代理只覆盖不追加头部，防止 IP 欺骗

---

9. 分页、排序与外部调用健壮性

Skill 会自动补全分页、排序（PageRequest.of），并提供带重试机制的外部调用模式。

PageRequest page = PageRequest.of(pageNumber, pageSize, Sort.by("createdAt").descending());
Page<Market> results = marketService.list(page);

外部调用重试模板：

public <T> T withRetry(Supplier<T> supplier, int maxRetries) {
  int attempts = 0;
  while (true) {
    try {
      return supplier.get();
    } catch (Exception ex) {
      attempts++;
      if (attempts >= maxRetries) {
        throw ex;
      }
      try {
        Thread.sleep((long) Math.pow(2, attempts) * 100L);
      } catch (InterruptedException ie) {
        Thread.currentThread().interrupt();
        throw ex;
      }
    }
  }
}

---

10. 生产级配置与最佳实践建议

Skill 会输出如下建议：

• 优先使用构造器注入，避免字段注入
• 启用 spring.mvc.problemdetails.enabled=true（Spring Boot 3+）
• 配置 HikariCP 连接池与超时
• 查询方法加 @Transactional(readOnly = true)
• 用 @NonNull、Optional 强化空安全
• 控制器保持精简，业务逻辑聚合到 Service，统一异常处理

---

Skill 输出示例

AI 助手输出的完整代码结构通常包括：

• Controller/Service/Repository/DTO/ExceptionHandler/Filter 各层代码
• 配套的配置类（如 @EnableCaching, @EnableAsync）
• 关键注释与安全提示
• 生产环境优化建议

你可以直接复制粘贴到 Spring Boot 项目，或让 AI 继续补全测试、文档等内容。

---

常见配套 Agent 与 Skill 协作

• 与 Java Reviewer Agent 配合，自动审查生成代码的规范性与安全性
• 搭配 Spring Boot Security Skill 强化认证、授权、限流等安全环节
• 与 Spring Boot TDD Skill 组合，自动生成单元/集成测试
• 可与 JPA Patterns Skill 深度集成，优化实体关系与查询性能
• 结合 Verification Loop Skill 实现端到端自动化验证

更多高级用法可参考 Claude Code 高级技巧。

---

FAQ

Q: Spring Boot Patterns Skill 适合新项目还是老项目重构？
A: 两者皆可。新项目可直接生成标准骨架，老项目重构时可用来识别和补全缺失的分层、异常处理、缓存等模式。

Q: Skill 输出的代码如何保证安全？
A: Skill 内置安全最佳实践（如限流、异常处理、安全日志），并推荐与 Security Skill/Agent 联合使用，进一步提升安全性。

Q: 可以自定义 Skill 输出的代码风格或规范吗？
A: 可以。可结合项目级 Rules 或 Coding Standards Skill，自定义代码风格、注释、命名等输出细节。

---