spring-boot-3 — скилл для Claude Code: паттерны Spring Boot 3
Набор правил для ИИ-агента: как писать конфигурацию, инъекцию зависимостей и REST-слой в Spring Boot 3, чтобы код не разъезжался по стилю.
MIT 143 установок ★ 678 обновлён 2026-03-28
npx skills add Gentleman-Programming/Gentleman-Skills --skill spring-boot-3 -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/spring-boot-3/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/spring-boot-3/
1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill spring-boot-3 -a codex2Вручную: положить файлы
.agents/skills/spring-boot-3/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill spring-boot-3 -a cursor2Вручную: положить файлы
.cursor/skills/spring-boot-3/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install Gentleman-Programming/Gentleman-Skills community/spring-boot-3/SKILL.md2Вручную: положить файлы
.github/skills/spring-boot-3/SKILL.md1Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill spring-boot-3 -a gemini-cli2Командой платформы
gemini skills install https://github.com/Gentleman-Programming/Gentleman-Skills --path community/spring-boot-3Вручную: положить файлы
.devin/skills/spring-boot-3/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add Gentleman-Programming/Gentleman-Skills --skill spring-boot-3 -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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