spring-performance · kyy-logs, code-review-gate — правило для Claude Code
Правило spring-performance для Claude Code задаёт проверки Spring/JPA и производительности. Оно помогает находить ошибки валидации, транзакциях, запросах и пакетной обработке.
MIT ★ 517 обновлён 2026-11-16
.claude/rules/spring-performance.mdЧто делает 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
Codex читает AGENTS.md: вставьте текст правила туда
Вручную: положить файлы
.cursor/rules/spring-performance.mdcВо frontmatter: description, globs, alwaysApply
Вручную: положить файлы
.github/instructions/spring-performance.instructions.mdПоле applyTo задаёт, к каким файлам применять
Вручную: положить файлы
.devin/rules/spring-performance.mdВручную: положить файлы
.clinerules/spring-performance.mdПо шагам, с командами для каждой платформы: 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 от других авторов.