К основному содержанию
скилл CX Codex

spring-boot-3 — скилл для Claude Code: паттерны Spring Boot 3

Набор правил для ИИ-агента: как писать конфигурацию, инъекцию зависимостей и REST-слой в Spring Boot 3, чтобы код не разъезжался по стилю.

MIT 143 установок ★ 678 обновлён 2026-03-28

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add Gentleman-Programming/Gentleman-Skills --skill spring-boot-3 -a claude-code
Открыть на GitHub

Что делает spring-boot-3

Скилл задаёт агенту набор правил для Spring Boot 3: бины собираются через конструктор, конфигурация живёт в типизированных @ConfigurationProperties с валидацией, @Transactional ставится на методы сервисов, а не контроллеров. Внутри есть примеры кода и разбор анти-паттернов: field injection и @Value, разбросанные по классам.

Контроллер в примерах принимает DTO-запись и сам переводит её в команду для сервиса. Валидация опирается на jakarta.validation, поэтому зависимость должна быть в проекте: без неё @NotBlank в записи свойств не скомпилируется. Сканирование свойств включает @ConfigurationPropertiesScan на главном классе.

Ставится одной командой npx skills add, файл SKILL.md ложится в каталог скиллов платформы. Дальше агент подхватывает его сам, когда вы просите собрать или отрефакторить сервис.

Какие задачи решает

  • собрать @ConfigurationProperties с валидацией вместо россыпи @Value
  • перевести сервисы на конструкторную инъекцию
  • расставить @Transactional на сервисном слое, а не в контроллерах
  • описать REST-контроллер с DTO-записями и маппингом в команду
  • вычистить field injection из старого кода

Примеры запросов агенту

  • Добавь в проект PaymentProperties с @ConfigurationProperties(prefix = "payment") и валидацией полей.
  • Отрефактори OrderService: конструкторная инъекция и @Transactional на методе placeOrder.
  • Проверь контроллеры и сервисы на field injection и разбросанные @Value.

Как установить spring-boot-3

1Через Skills CLI (Vercel)

npx skills add Gentleman-Programming/Gentleman-Skills --skill spring-boot-3 -a claude-code

2Вручную: положить файлы

~/.claude/skills/spring-boot-3/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/spring-boot-3/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о spring-boot-3

Как установить spring-boot-3 в Claude Code?

Выполните npx skills add Gentleman-Programming/Gentleman-Skills --skill spring-boot-3 -a claude-code. Файл скилла появится по пути ~/.claude/skills/spring-boot-3/SKILL.md.

Что делает spring-boot-3?

Подсказывает агенту паттерны Spring Boot 3: конструкторную инъекцию, типизированные свойства с валидацией, границы транзакций на сервисах и тонкие контроллеры с DTO-записями.

Какие версии Spring Boot подходят?

Скилл рассчитан на 3.3 и новее. Примеры построены на records, jakarta.validation и @ConfigurationPropertiesScan.

Исходный текст

SKILL.md · MIT
---
name: spring-boot-3
description: >
  Spring Boot 3 patterns for configuration, DI, and web services.
  Trigger: When building or refactoring Spring Boot 3 applications.
metadata:
  author: diegnghrmr
  version: "1.0"
---

## When to Use

Load this skill when:
- Building a Spring Boot 3.3+ service or API
- Wiring beans with dependency injection
- Defining configuration properties and validation
- Implementing REST controllers and service layers

## Critical Patterns

### Pattern 1: Constructor injection only

Always use constructor injection; avoid field injection.

### Pattern 2: Typed configuration properties

Use @ConfigurationProperties with validation, not scattered @Value.

### Pattern 3: Transaction boundaries at service layer

Apply @Transactional on application services, not controllers.

## Code Examples

### Example 1: Configuration properties with validation

```java
package com.acme.config;

import jakarta.validation.constraints.NotBlank;
import org.springframework.boot.context.properties.ConfigurationProperties;
import org.springframework.validation.annotation.Validated;

@Validated
@ConfigurationProperties(prefix = "payment")
public record PaymentProperties(
  @NotBlank String provider,
  @NotBlank String apiKey
) { }
```

```java
package com.acme;

import org.springframework.boot.context.properties.ConfigurationPropertiesScan;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
@ConfigurationPropertiesScan
public class Application { }
```

### Example 2: Service with constructor injection + transaction

```java
package com.acme.order.application;

import org.springframework.stereotype.Service;
import org.springframework.transaction.annotation.Transactional;

@Service
public final class OrderService {
  private final OrderRepository repository;

  public OrderService(OrderRepository repository) {
    this.repository = repository;
  }

  @Transactional
  public void placeOrder(OrderCommand command) {
    repository.save(command.toEntity());
  }
}
```

### Example 3: REST controller with DTO records

```java
package com.acme.order.api;

import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.*;

@RestController
@RequestMapping("/orders")
public final class OrderController {
  private final OrderService service;

  public OrderController(OrderService service) {
    this.service = service;
  }

  @PostMapping
  public ResponseEntity<OrderResponse> place(@RequestBody OrderRequest request) {
    service.placeOrder(request.toCommand());
    return ResponseEntity.ok(new OrderResponse("ok"));
  }

  public record OrderRequest(String sku, int qty) {
    public OrderCommand toCommand() { return new OrderCommand(sku, qty); }
  }

  public record OrderResponse(String status) { }
}
```

## Anti-Patterns

### Don't: Use field injection

```java
// BAD: field injection
@Service
public class OrderService {
  @org.springframework.beans.factory.annotation.Autowired
  private OrderRepository repository;
}
```

### Don't: Scatter configuration with @Value

```java
// BAD: hard to validate and test
@Service
public class PaymentService {
  @org.springframework.beans.factory.annotation.Value("${payment.apiKey}")
  private String apiKey;
}
```

## Quick Reference

| Task | Pattern |
|------|---------|
| Inject dependencies | Constructor injection only |
| Read config | @ConfigurationProperties + @Validated |
| Transactions | @Transactional on services |

## Resources

- Spring Boot Reference: https://docs.spring.io/spring-boot/docs/current/reference/html/
- Spring Framework Reference: https://docs.spring.io/spring-framework/reference/

© diegnghrmr · MIT · Gentleman-Programming/Gentleman-Skills

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
spring-boot-development manutej Скилл spring-boot-development для ИИ-агента, который подсказывает, как писать Spring Boot: авто-конфигурация, внедрение зависимостей, REST-контроллеры, Spring Data и Spring Security. CX Codex +1 537установок spring-boot-dependency-injection giuseppe-trisciuoglio Скилл spring-boot-dependency-injection внедряет паттерны внедрения зависимостей через конструктор в Spring Boot. Он помогает избавиться от field injection и настроить выбор бинов через @Primary и @Qualifier. CX Codex +1 4 000установок spring-boot-engineer https://github.com/Jeffallan Скилл spring-boot-engineer разворачивает архитектуру Spring Boot 3.x, контроллеры, репозитории Spring Data JPA и правила Spring Security 6. Пригодится при сборке REST API, реактивных сервисов и микросервисов на Java. CX Codex +1 8 900установок spring-boot-rest-api-standards giuseppe-trisciuoglio Скилл spring-boot-rest-api-standards задаёт правила проектирования REST API в Spring Boot: от структуры URL и статус-кодов до валидации DTO и перехвата ошибок. CX Codex +1 4 400установок spring-boot Mindrally Задаёт агенту стиль кода на Spring Boot: REST-контроллеры, тесты, безопасность, сборка и деплой. Обеспечивает единообразие в проектах на Java. CX Codex +1 881установок 302-frameworks-spring-boot-rest Juan Antonio Breña Moral Скилл 302-frameworks-spring-boot-rest для проектирования и разбора REST API на Spring Boot: методы, коды ответов, DTO, версионирование, пагинация, ошибки по RFC 7807. CX Codex +1 420установок

Из того же набора20

Весь набор →
elixir-antipatterns Скилл elixir-antipatterns для Claude Code содержит восемь антипаттернов Elixir и Phoenix для код-ревью и рефакторинга, включая N+1 в Ecto и логику в LiveView. CX Codex +1 194установок nextjs-15 Скилл задаёт паттерны работы с App Router в Next.js 15: маршрутизацию, Server Actions, параллельную загрузку данных и настройку middleware. CX Codex +1 185установок electron Организует структуру проекта на Electron, настраивает безопасный IPC через contextBridge и даёт типизированные шаблоны взаимодействия между процессами. CX Codex +1 175установок skill-creator Скилл skill-creator для Claude Code создаёт новые скиллы по спецификации Agent Skills. Оформляет повторяемые паттерны, проектные правила и сложные рабочие процессы. CX Codex +1 171установок django-drf Скилл django-drf помогает проектировать REST API на Django: ViewSet, сериализаторы, фильтры и тесты. Пригодится при сборке нового API. CX Codex +1 162установок angular-forms Скилл angular-forms для работы с формами Angular: покрывает Signal Forms (экспериментальные, на Angular 21+) и Reactive Forms для продакшена. Триггер срабатывает при работе с валидацией, состоянием формы или её созданием. CX Codex +1 150установок ai-sdk-5 Помогает писать код на Vercel AI SDK 5 с учётом ломающих изменений после четвёртой версии. CX Codex +1 138установок jira-epic Скилл jira-epic генерирует готовые описания эпиков в Jira по стандарту Prowler со схемами Mermaid и разбивкой на задачи. CX Codex +1 138установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой