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

spring-performance · kyy-logs, code-review-gate — правило для Claude Code

Правило spring-performance для Claude Code задаёт проверки Spring/JPA и производительности. Оно помогает находить ошибки валидации, транзакциях, запросах и пакетной обработке.

MIT ★ 517 обновлён 2026-11-16

Установить в Claude Code · Вручную: положить файлы Все способы и платформы ↓
.claude/rules/spring-performance.md
Открыть на GitHub

Что делает spring-performance

Правило задаёт рекомендации для кода на Spring и JPA: проверять входные параметры через @Valid, явно задавать границы транзакций и обрабатывать исключения через @RestControllerAdvice. Для связей сущностей оно предлагает искать N+1 запросы и использовать JOIN FETCH или EntityGraph.

Также правило проверяет создание строк в циклах и вставку записей по одной, предлагая StringBuilder, String.join и пакетные операции. В рекомендациях для сервера есть параметры Linux и JVM; в частности, указан лимит ulimit -n 65535, поскольку стандартного лимита Linux в 1024 дескриптора недостаточно. Для Claude Code файл нужно разместить по пути .claude/rules/spring-performance.md.

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

  • найти пропущенную валидацию параметров Spring-контроллера
  • обнаружить границы транзакций, заданные некорректно
  • заметить N+1 запросы при загрузке связанных сущностей
  • заменить вставки по одной пакетной операцией
  • найти создание строк через конкатенацию в цикле

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

  • Проверь Spring-контроллеры на пропущенную валидацию запросов.
  • Найди в JPA-коде N+1 запросы и предложи исправление.
  • Проверь сервисы на ошибки в транзакциях и пакетных вставках.

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

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

.claude/rules/spring-performance.md

Поле paths во frontmatter ограничивает файлы

По шагам, с командами для каждой платформы: AGENTS.md и CLAUDE.md: что это, кто читает и какой выбрать

Вопросы о spring-performance

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

Помести файл правила в проект по пути .claude/rules/spring-performance.md.

Что делает spring-performance?

Правило задаёт проверки Spring/JPA и производительности: от валидации параметров и транзакций до N+1 запросов и пакетных вставок.

Что spring-performance проверяет в JPA-запросах?

Оно помогает находить N+1 запросы при загрузке связанных сущностей и предлагает использовать JOIN FETCH или EntityGraph.

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

spring-performance.md · MIT
# Spring/JPA and performance guidelines

## Spring/JPA best practices

### Parameter validation
**Detection mode**: semantic

```java
// Correct: validate with @Valid
@PostMapping("/users")
public UserDTO createUser(@Valid @RequestBody UserCreateRequest request) {
    return userService.create(request);
}

@Data
public class UserCreateRequest {
    @NotBlank(message = "username must not be blank")
    @Size(min = 2, max = 50, message = "username length must be 2-50")
    private String name;
    
    @Email(message = "invalid email format")
    private String email;
    
    @Min(value = 0, message = "age must not be negative")
    private Integer age;
}
```

### Transaction management
**Detection mode**: semantic

```java
// Correct: explicit transaction scope
@Transactional(rollbackFor = Exception.class)
public void createUser(User user, UserProfile profile) {
    userDao.insert(user);
    profile.setUserId(user.getId());
    profileDao.insert(profile);
}

// Note: read-only operations should not use a transaction, or should use a read-only transaction
@Transactional(readOnly = true)
public User getUser(Long id) {
    return userDao.findById(id);
}
```

### N+1 query prevention
**Detection mode**: semantic

```java
// Wrong: N+1 queries
List<User> users = userDao.findAll();
for (User user : users) {
    List<Order> orders = orderDao.findByUserId(user.getId());  // N queries!
    user.setOrders(orders);
}

// Correct: use JOIN FETCH
@Query("SELECT u FROM User u LEFT JOIN FETCH u.orders WHERE u.id IN :ids")
List<User> findWithOrders(@Param("ids") List<Long> ids);

// Or use EntityGraph
@Entity
@NamedEntityGraph(name = "User.withOrders", 
    attributeNodes = @NamedAttributeNode("orders"))
public class User { ... }
```

### Unified exception handling
**Detection mode**: semantic

```java
// Unified exception handling
@RestControllerAdvice
public class GlobalExceptionHandler {
    
    @ExceptionHandler(BusinessException.class)
    public ResponseEntity<ErrorResponse> handleBusiness(BusinessException e) {
        return ResponseEntity.badRequest()
            .body(new ErrorResponse(e.getCode(), e.getMessage()));
    }
    
    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleOther(Exception e) {
        log.error("Unexpected error", e);
        return ResponseEntity.internalServerError()
            .body(new ErrorResponse("SYSTEM_ERROR", "system error"));
    }
}
```

## Performance guidelines

### Server configuration
**Detection mode**: semantic

| Setting | Description | Recommended value |
|-------|------|-------|
| TCP time_wait timeout | Lower it in high-concurrency scenarios | `net.ipv4.tcp_fin_timeout=30` |
| Maximum file handles | The Linux default of 1024 is insufficient | `ulimit -n 65535` |
| JVM HeapDump | Generate a heap dump on OOM | `-XX:+HeapDumpOnOutOfMemoryError` |

### Object creation
**Detection mode**: semantic

```java
// Wrong: create strings in a loop
String result = "";
for (String item : list) {
    result += item + ",";  // creates a new String each time!
}

// Correct: use StringBuilder
StringBuilder sb = new StringBuilder();
for (String item : list) {
    if (sb.length() > 0) sb.append(",");
    sb.append(item);
}
String result = sb.toString();

// Or use String.join
String result = String.join(",", list);
```

### Batch operations
**Detection mode**: semantic

```java
// Wrong: one insert per iteration
for (User user : users) {
    userDao.insert(user);  // N IOs!
}

// Correct: batch insert
userDao.batchInsert(users);
```

© kyy-logs · MIT · kyy-logs/code-review-gate-skill

Похожие правила IDE

Все правила IDE по теме «Бэкенд и API» →

Сначала — spring-performance от других авторов.

spring-performance kyy-logs Правило spring-performance для Claude Code задаёт практики Spring/JPA и оптимизации производительности. Агент применяет их при работе с Java-кодом и запросами к базе данных. CX Codex +1 ★ 517звёзд репо 311-frameworks-spring-jdbc Juan Antonio Breña Moral Скилл 311-frameworks-spring-jdbc для ревью и написания JDBC-кода на Spring: подсказывает JdbcClient, ловит SQL-инъекции и правит границы транзакций. CX Codex +1 352установок java-spring-boot pluginagentmarketplace Скилл java-spring-boot помогает создавать бэкенд на Spring Boot 3: настраивать REST API, аутентификацию через Spring Security, доступ к базам через Spring Data и мониторинг Actuator. CX Codex +1 11 800установок spring-data-jpa giuseppe-trisciuoglio Скилл spring-data-jpa для Claude Code помогает создавать репозитории и настраивать связи сущностей. Он подключается к задачам с запросами, транзакциями, аудитом и пагинацией. CX Codex +1 4 300установок spring-boot-crud-patterns giuseppe-trisciuoglio Скилл spring-boot-crud-patterns собирает полный CRUD-слой для сервисов на Spring Boot 3: агрегаты, JPA-репозитории, DTO и REST-контроллеры по feature-архитектуре. CX Codex +1 4 100установок spring-boot-patterns decebals Скилл spring-boot-patterns для Claude Code задаёт структуру и шаблоны Spring Boot-проекта: контроллеры, сервисы, репозитории. Направляет агента при написании нового кода и разборе чужого. CX Codex +1 375установок 312-frameworks-spring-data-jdbc Juan Antonio Breña Moral Скилл 312-frameworks-spring-data-jdbc для работы с Spring Data JDBC на Java records: сущности, репозитории, границы агрегатов, транзакции и борьба с N+1. CX Codex +1 349установок

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

Весь набор →
index Правило index для Claude Code описывает состав набора правил проверки кода и порядок их поиска. Проектный набор заменяет встроенный целиком, а не дополняет его. CX Codex +1 ★ 517звёзд репо baseline-java Правило baseline-java для Claude Code добавляет проверки безопасности, многопоточности и обработки исключений в Java. Агент применяет его при разборе Java-кода. CX Codex +1 ★ 517звёзд репо spring-performance Правило spring-performance для Claude Code задаёт практики Spring/JPA и оптимизации производительности. Агент применяет их при работе с Java-кодом и запросами к базе данных. CX Codex +1 ★ 517звёзд репо concurrency Правило concurrency для Claude Code задаёт требования к многопоточности в Java-коде. Оно охватывает пулы потоков, блокировки, общие данные и другие источники ошибок конкурентного доступа. CX Codex +1 ★ 517звёзд репо exception-logging Правило exception-logging для Claude Code проверяет обработку исключений и логирование в коде на Java. Контролирует пустые блоки catch, вызовы SLF4J, маскирование данных и откат транзакций. CX Codex +1 ★ 517звёзд репо naming-format Правило naming-format для Claude Code задаёт соглашения об именах и форматировании Java-кода. Оно охватывает классы, методы, константы и управляющие конструкции. CX Codex +1 ★ 517звёзд репо testing-engineering Правило testing-engineering для Claude Code задаёт требования к юнит-тестам, архитектуре проекта и зависимостям. Оно охватывает проектирование слоёв, обработку исключений и соглашения для моделей данных. CX Codex +1 ★ 517звёзд репо code-review-gate Скилл code-review-gate для Claude Code проверяет изменения в коде перед коммитом или слиянием PR. Агент собирает diff, запускает проверки и фиксирует найденные проблемы. CX Codex +1 ★ 517звёзд репо

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

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