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

devkit.java.refactor-class — команда для Claude Code: рефакторинг Java

Команда devkit.java.refactor-class для Claude Code, которая анализирует Java-класс и переписывает его по Clean Architecture, DDD и Spring Boot-паттернам. Принимает путь к файлу, область рефакторинга и опции вроде dry-run или backup.

MIT ★ 372 обновлён 2026-09-10

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add giuseppe-trisciuoglio/developer-kit
/plugin install developer-kit-java@developer-kit
Открыть на GitHub

Что делает devkit.java.refactor-class

Команда запускается вызовом /devkit.java.refactor-class с тремя аргументами: путь к .java-файлу, область рефакторинга и дополнительные флаги. Если путь не передан, она сама найдёт самый сложный класс в проекте.

Область рефакторинга задаёт, что именно трогать. cleanup — форматирование, мёртвый код, цикломатическая сложность ниже 10. architecture — разбивка по слоям Clean Architecture, конструкторная инъекция, репозиторный паттерн. performance — оптимизация JPA-запросов, устранение N+1, добавление @Cacheable. security — Jakarta Bean Validation, @PreAuthorize, защита от SQL-инъекций. testing — покрытие по AAA, Mockito без статических моков, Testcontainers для persistence-слоя. comprehensive включает всё сразу.

Перед правками команда прогоняет тесты через ./gradlew test или mvn test, а если не передан флаг dry-run, создаёт отдельную ветку с именем вида refactor/<ClassName>-<timestamp>. Инструменты Read, Write, Bash, Edit, Grep, Glob доступны по умолчанию — на внешние сервисы команда не ходит.

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

  • разбить God-класс на сервисы с одной ответственностью
  • выстроить слои Clean Architecture в Spring Boot-проекте
  • устранить N+1-запросы и добавить кэширование через @Cacheable
  • добавить Jakarta Bean Validation и @PreAuthorize к существующим контроллерам
  • подготовить класс к тестированию: заменить статические зависимости на инжектируемые

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

  • Отрефактори src/main/java/com/example/OrderService.java по архитектурным паттернам
  • Запусти /devkit.java.refactor-class src/main/java/UserController.java security dry-run
  • Проведи полный рефакторинг src/main/java/PaymentProcessor.java comprehensive backup

Как установить devkit.java.refactor-class

1Через маркетплейс плагинов

/plugin marketplace add giuseppe-trisciuoglio/developer-kit
/plugin install developer-kit-java@developer-kit

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

.claude/commands/devkit.java.refactor-class.md

Вызов — /devkit.java.refactor-class. Для всех проектов — ~/.claude/commands/

Вопросы о devkit.java.refactor-class

Как установить devkit.java.refactor-class в Claude Code?

Выполните последовательно: /plugin marketplace add giuseppe-trisciuoglio/developer-kit, затем /plugin install developer-kit-java@developer-kit. После этого команда доступна по пути .claude/commands/devkit.java.refactor-class.md.

Что делает devkit.java.refactor-class?

Команда анализирует Java-класс, определяет нарушения архитектурных паттернов и переписывает код по Clean Architecture, DDD и Spring Boot best practices. Область правок управляется вторым аргументом: от косметики (cleanup) до полного рефакторинга (comprehensive).

Безопасно ли запускать команду на рабочей ветке?

При любом режиме, кроме dry-run, команда автоматически создаёт отдельную ветку вида refactor/<ClassName>-<timestamp> и прогоняет тесты перед каждым изменением. Флаг dry-run показывает план без записи файлов.

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

devkit.java.refactor-class.md · MIT
---
allowed-tools: Read, Write, Bash, Edit, Grep, Glob
argument-hint: "[class-file-path] [refactoring-scope] [options]"
description: Provides intelligent refactoring for complex Java classes with architectural analysis and Spring Boot patterns. Use when refactoring large or complex Java classes.
model: inherit
---

# Java Class Refactoring Assistant

## Overview

Intelligently refactor complex Java classes following Clean Architecture, DDD patterns, and Spring Boot best practices.

Provides intelligent refactoring for complex Java classes with architectural analysis and Spring Boot patterns. Use when
refactoring large or complex Java classes.

## Usage

```
/devkit.java.refactor-class $ARGUMENTS
```

## Arguments

| Argument     | Description                              |
|--------------|------------------------------------------|
| `$ARGUMENTS` | Combined arguments passed to the command |

## Current Context

- **Current Git Branch**: !`git branch --show-current`
- **Git Status**: !`git status --porcelain`
- **Recent Commits**: !`git log --oneline -5`
- **Test Coverage**: !`find . -name "*Test.java" -type f | wc -l` test files found

## Execution Instructions

**Agent Selection**: To execute this task, use the following agent with fallback:

- Primary: `developer-kit-java:java-refactor-expert`
- If not available: Use `developer-kit-java:java-refactor-expert` or fallback to `general-purpose` agent with
  `spring-boot-crud-patterns` skill

## Refactoring Configuration

Analyzing: **$ARGUMENTS**

**Parameters:**

- `$1` - Class file path (required): Path to Java class to refactor
- `$2` - Refactoring scope (optional):
    - `cleanup` - Code cleanup and style improvements (default)
    - `architecture` - Architectural pattern improvements
    - `performance` - Performance optimizations
    - `security` - Security enhancements
    - `testing` - Testability improvements
    - `comprehensive` - All improvements (full refactor)
- `$3` - Options (optional): `dry-run`, `backup`, `validate-only`

## Pre-Refactoring Analysis

### 1. Class Identification and Context

IF "$1" is empty OR not provided
THEN Analyze the most complex class in the codebase automatically
ELSE Analyze specific class: $1
ENDIF

### 2. Architecture Pattern Detection

```
Expected Clean Architecture Structure:
feature/
├── domain/
│   ├── model/           # Domain entities (Spring-free)
│   ├── repository/      # Domain ports (interfaces)
│   └── service/         # Domain services
├── application/
│   ├── service/         # Use cases (@Service beans)
│   └── dto/             # Immutable DTOs/records
├── presentation/
│   └── rest/            # Controllers and mappers
└── infrastructure/
    └── persistence/     # JPA adapters
```

## Refactoring Strategy by Scope

### Cleanup Refactoring ($2 = "cleanup")

- **Code Style**: Apply consistent formatting, naming conventions
- **Dead Code**: Remove unused imports, methods, variables
- **Complexity**: Simplify complex methods (< 10 cyclomatic complexity)
- **Documentation**: Add missing JavaDoc and inline comments
- **Immutability**: Convert to immutable structures where possible

### Architecture Refactoring ($2 = "architecture")

- **Layer Separation**: Ensure proper dependency direction
- **DDD Patterns**: Apply aggregates, value objects, domain events
- **Spring Patterns**: Constructor injection, proper bean scoping
- **Repository Pattern**: Domain interfaces + infrastructure adapters
- **DTO Pattern**: Replace JPA entities with records in APIs

### Performance Refactoring ($2 = "performance")

- **Database Queries**: Optimize JPA queries, eliminate N+1 problems
- **Caching**: Add @Cacheable, @CachePut, @CacheEvict where appropriate
- **Async Processing**: Convert blocking operations to @Async
- **Memory Management**: Identify and fix memory leaks
- **Algorithm Optimization**: Improve computational complexity

### Security Refactoring ($2 = "security")

- **Input Validation**: Add Jakarta Bean Validation
- **Authentication**: Ensure proper @PreAuthorize usage
- **Data Exposure**: Prevent sensitive data leakage in DTOs
- **SQL Injection**: Verify safe JPA usage
- **XSS Prevention**: Input sanitization and output encoding

### Testing Refactoring ($2 = "testing")

- **Testability**: Extract dependencies for better mocking
- **Test Coverage**: Add missing unit/integration tests
- **Test Structure**: Apply AAA pattern (Arrange, Act, Assert)
- **Mocking**: Proper Mockito usage without static mocks
- **Testcontainers**: Real database testing for persistence layer

## Refactoring Process

### Phase 1: Analysis and Planning

1. **Read and analyze target class** for current patterns and violations
2. **Identify dependencies** and usage patterns across codebase
3. **Assess test coverage** - if missing, create tests BEFORE refactoring
4. **Create refactoring plan** based on selected scope
5. **Backup strategy** - create branch if not `dry-run`

### Phase 2: Safety Checks

```bash
# Run existing tests
./gradlew test || mvn test

# Create backup branch if not dry-run
if [ "$3" != "dry-run" ]; then
  git checkout -b refactor/$(basename "$1" .java)-$(date +%Y%m%d-%H%M%S)
fi
```

### Phase 3: Incremental Refactoring

For each refactoring step:

1. **Make small, focused change**
2. **Run tests** to verify no regressions
3. **Commit change** with descriptive message
4. **Document improvement** and rationale

### Phase 4: Validation

```bash
# Full test suite
./gradlew test || mvn test

# Static analysis
./gradlew spotbugsMain || ./gradlew checkstyleMain

# Performance validation
./gradlew bench || echo "No performance tests configured"
```

## Common Refactoring Patterns

### Extract Method/Service

```java
// Before: Complex method doing too much
@Service
@RequiredArgsConstructor
public class OrderService {
    public OrderDto createOrder(CreateOrderRequest request) {
        // Validation logic (20+ lines)
        // Business logic (30+ lines)
        // Notification logic (15+ lines)
        // Audit logic (10+ lines)
    }
}

// After: Extracted responsibilities
@Service
@RequiredArgsConstructor
public class OrderService {
    private final OrderValidator validator;
    private final OrderProcessor processor;
    private final NotificationService notificationService;
    private final AuditService auditService;

    public OrderDto createOrder(CreateOrderRequest request) {
        validator.validate(request);
        var order = processor.process(request);
        notificationService.sendOrderCreated(order);
        auditService.logOrderCreation(order);
        return order;
    }
}
```

### Replace with Record/Value Object

```java
// Before: Mutable entity exposed
public class UserDto {
    private String name;
    private String email;
    // getters/setters
}

// After: Immutable record
public record UserDto(String id, String name, String email, Instant createdAt) {
}
```

### Apply Repository Pattern

```java
// Domain port (interface)
public interface UserRepository {
    User save(User user);

    Optional<User> findById(UserId id);

    List<User> findByEmail(String email);
}

// Infrastructure adapter
@Repository
@RequiredArgsConstructor
public class UserRepositoryAdapter implements UserRepository {
    private final UserJpaRepository jpaRepository;
    private final UserMapper mapper;

    @Override
    public User save(User user) {
        var entity = mapper.toEntity(user);
        var saved = jpaRepository.save(entity);
        return mapper.toDomain(saved);
    }
}
```

### Add Spring Security

```java
// Before: No authorization
@PreAuthorize("hasRole('ADMIN')")
@GetMapping("/api/admin/users")
public ResponseEntity<List<UserDto>> getAllUsers() {
    // Implementation
}

// After: Method-level security
@PreAuthorize("hasRole('ADMIN') or hasAuthority('USERS_READ')")
@GetMapping("/api/admin/users")
public ResponseEntity<List<UserDto>> getAllUsers() {
    // Implementation
}
```

## Output and Reporting

### Refactoring Summary

- **Files Modified**: List of changed files with line counts
- **Patterns Applied**: Specific patterns and improvements made
- **Test Impact**: New tests added, existing tests updated
- **Performance Changes**: Before/after metrics if available

### Quality Metrics

- **Cyclomatic Complexity**: Reduced from X to Y
- **Lines of Code**: Reduced by X%
- **Test Coverage**: Increased from X% to Y%
- **Dependencies**: Reduced coupling between components

### Next Steps

1. **Review changes** with team
2. **Run integration tests** in staging environment
3. **Monitor performance** after deployment
4. **Update documentation** for changed APIs

## Integration with Skills

This command works best with these skills:

- **spring-boot-crud-patterns**: For CRUD refactoring
- **spring-boot-test-patterns**: For test improvements
- **spring-boot-rest-api-standards**: For API refactoring
- **unit-test-service-layer**: For service layer testing

## Safety and Validation

- **Always preserve external behavior** while improving internal structure
- **Maintain backward compatibility** for public APIs
- **Create comprehensive tests** before refactoring critical paths
- **Use feature flags** for large, risky refactoring
- **Monitor production metrics** after deployment

## Examples

```bash
# Cleanup and style improvements
/developer-kit-java:devkit.java.refactor-class src/main/java/com/example/service/UserService.java cleanup

# Full architectural refactoring with backup
/developer-kit-java:devkit.java.refactor-class src/main/java/com/example/service/OrderService.java comprehensive backup

# Performance optimization only
/developer-kit-java:devkit.java.refactor-class src/main/java/com/example/repository/ProductRepository.java performance

# Dry run to see what would change
/developer-kit-java:devkit.java.refactor-class src/main/java/com/example/controller/UserController.java architecture dry-run

# Automatic complex class detection
/developer-kit-java:devkit.java.refactor-class
```

© Giuseppe Trisciuoglio · MIT · giuseppe-trisciuoglio/developer-kit

Похожие слэш-команды

Все слэш-команды по теме «Код-ревью и рефакторинг» →
163-java-profiling-refactor Juan Antonio Breña Moral Скилл 163-java-profiling-refactor берёт готовый отчёт профилирования и правит Java-код по найденным узким местам: CPU, память, потоки. Полезен, когда анализ уже сделан и пора что-то менять. CX Codex +1 359установок hexagonal-architecture-layers-java diegnghrmr Скилл hexagonal-architecture-layers-java раскладывает Java-сервис по слоям Domain, Application и Infrastructure. Нужен при создании сервиса или рефакторинге Spring-кода. CX Codex +1 250установок refactor-expert alirezarezvani Субагент refactor-expert для Claude Code анализирует качество кода и планирует безопасный рефакторинг. Ищет дублирование, архитектурные проблемы и пробелы в тестах. CX Codex ★ 788звёзд репо create-spring-boot-java-project официальный github Скилл create-spring-boot-java-project разворачивает каркас приложения Spring Boot через start.spring.io с готовой конфигурацией базы данных, тестов и Docker. Запускается при запросе на генерацию нового сервиса на Java. CX Codex +1 9 516установок java-coding-standards affaan-m Скилл java-coding-standards применяет правила Java к коду для Spring Boot и Quarkus. Подключайте его при написании или ревью сервисов на этих фреймворках. CX Codex +1 6 900установок java-mcp-server-generator официальный github Скилл java-mcp-server-generator для GitHub Copilot и Claude Code создаёт Java MCP-сервер или Spring Boot-проект для подключения кода, API и баз данных к AI-агентам. В проект входят тесты. CX Codex +1 8 800установок

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

Весь набор →
general-code-explorer Субагент general-code-explorer разбирает реализацию фич в кодовой базе: находит точки входа, отслеживает цепочки вызовов и строит отчёт по слоям архитектуры. CX Codex ★ 372звёзд репо devkit.generate-security-assessment Команда devkit.generate-security-assessment собирает структурированный документ по безопасности проекта на основе кода и результатов аудита. Запускайте её после проверки безопасности, чтобы оформить оценку в заданном языке и формате. CX Codex +1 ★ 372звёзд репо lambda-conventions Правило lambda-conventions задаёт структуру каталогов, именование и валидацию для AWS Lambda-функций на NestJS с SAM-развёртыванием. Помогает команде держать одинаковый формат обработчиков и конфигов. CX Codex +1 ★ 372звёзд репо aws-cloudformation-ec2 Скилл aws-cloudformation-ec2 помогает генерировать шаблоны CloudFormation для виртуальных машин EC2, групп безопасности, IAM-ролей и балансировщиков нагрузки ALB. CX Codex +1 ★ 372звёзд репо general-debugger Субагент general-debugger ведёт баг от симптома до строки, где всё ломается: читает стектрейс, проходит путь выполнения назад и предлагает точечную правку. CX Codex ★ 372звёзд репо document-generator-expert Субагент document-generator-expert генерирует технические отчёты, спецификации функций, регламенты процессов и оценки кодовой базы на основе файлов проекта. CX Codex ★ 372звёзд репо spring-boot-unit-testing-expert Субагент spring-boot-unit-testing-expert помогает писать и проверять модульные тесты Spring Boot с JUnit 5, Mockito и Spring Test. Вызывайте его при работе с тестами разных слоёв приложения. CX Codex ★ 372звёзд репо langchain4j-ai-development-expert Субагент langchain4j-ai-development-expert для разработки AI-приложений на LangChain4j: RAG-системы, чат-боты и MCP-серверы. Настраивает векторные хранилища, эмбеддинги и интеграцию моделей. CX Codex ★ 372звёзд репо

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

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