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

devkit.java.write-unit-tests — команда для Claude Code

Команда devkit.java.write-unit-tests создаёт модульные тесты на JUnit 5, Mockito и AssertJ по пути к Java-классу. Пригодится при тестировании сервисов, контроллеров и утилит в Spring Boot.

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

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

Что делает devkit.java.write-unit-tests

Команда анализирует исходный Java-файл, определяет тип компонента (@Service, @RestController, маппер или валидатор) и генерирует готовый тестовый класс. Для работы используются инструменты Read, Edit, Write, Bash, Grep и Glob. Шаблоны ориентированы на чистые юнит-тесты без поднятия тяжелого контекста Spring, что сохраняет скорость прогона через mvn test.

Внутри реализован выбор специализированного агента developer-kit-java:spring-boot-unit-testing-expert или откат к общему агенту с профильными навыками. Для контроллеров мокируются сервисы с проверкой HTTP-ответов, для сервисного слоя настраиваются @Mock и @InjectMocks, а для утилит фокус смещается на граничные значения без лишних моков.

Команда требует передачи пути к файлу класса в качестве аргумента. Без правильного расположения файлов исходного кода генератор не сможет автоматически сопоставить целевую папку в src/test/java/.

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

  • написать тесты JUnit 5 с моками Mockito для сервисного слоя
  • покрыть граничные условия и исключения через проверки AssertJ
  • создать изолированные тесты для Spring REST-контроллеров без загрузки контекста

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

  • /devkit.java.write-unit-tests src/main/java/com/example/UserService.java
  • /devkit.java.write-unit-tests src/main/java/com/example/OrderController.java

Как установить devkit.java.write-unit-tests

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

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

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

.claude/commands/devkit.java.write-unit-tests.md

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

Вопросы о devkit.java.write-unit-tests

Как установить devkit.java.write-unit-tests в Claude Code?

Выполните последовательно две команды: /plugin marketplace add giuseppe-trisciuoglio/developer-kit, затем /plugin install developer-kit-java@developer-kit.

Что делает devkit.java.write-unit-tests?

Команда разбирает публичные методы указанного Java-класса и генерирует полный файл тестов с проверками AssertJ, паттерном Arrange-Act-Assert и моками Mockito.

Загружает ли сгенерированный тест контекст Spring?

Нет, генератор целенаправленно исключает поднятие Spring context, чтобы изолированные тесты отрабатывали быстро.

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

devkit.java.write-unit-tests.md · MIT
---
allowed-tools: Read, Edit, Write, Bash, Grep, Glob
argument-hint: <class-file-path>
description: Generates comprehensive JUnit 5 unit tests for Java classes with Mockito mocking and AssertJ assertions. Use when writing unit tests for service, controller, or utility classes.
model: inherit
---

# Generate Java Unit Tests

## Overview

You are a Java testing expert specializing in JUnit 5, Mockito, and AssertJ. Generate comprehensive, maintainable unit
tests following Spring Boot best practices.

Generates comprehensive JUnit 5 unit tests for Java classes with Mockito mocking and AssertJ assertions. Use when
writing unit tests for service, controller, or utility classes.

## Usage

```
/devkit.java.write-unit-tests $ARGUMENTS
```

## Arguments

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

## Execution Instructions

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

- Primary: `developer-kit-java:spring-boot-unit-testing-expert`
- If not available: Use `developer-kit-java:spring-boot-unit-testing-expert` or fallback to `general-purpose` agent with
  `spring-boot-test-patterns` skill
## Instructions

### 1. Analyze the Java Class

Read and analyze the Java class provided in the argument: `$1`

Identify:

- **Class type**: @Service, @RestController, @Component, utility class, mapper, validator, etc.
- **Dependencies**: Injected repositories, clients, services, utilities
- **Methods**: Public methods to test (ignore private methods)
- **Business logic**: Workflows, validations, transformations, error handling
- **Edge cases**: Null values, empty collections, boundary conditions, exceptions

### 2. Select Appropriate Testing Strategy

Based on the class type, apply the relevant skill:

**For @Service classes**:

- Use skill: `unit-test-service-layer`
- Mock all dependencies with @Mock
- Use @InjectMocks for the service under test
- Focus on business logic validation
- Verify interactions with mocks

**For @RestController classes**:

- Use skill: `unit-test-controller-layer`
- Mock service dependencies
- Test request/response handling
- Verify HTTP status codes and response bodies
- Test validation and error handling

**For mappers/converters**:

- Use skill: `unit-test-mapper-converter`
- Test bidirectional mappings
- Test null handling
- Test partial data scenarios

**For utility classes**:

- Use skill: `unit-test-utility-methods`
- Test static methods
- Focus on edge cases and boundary conditions
- No mocking needed

**For validation logic**:

- Use skill: `unit-test-bean-validation`
- Test Jakarta Bean Validation constraints
- Test custom validators

**For exception handlers**:

- Use skill: `unit-test-exception-handler`
- Test all exception scenarios
- Verify error response structure

**For caching logic**:

- Use skill: `unit-test-caching`
- Test cache hits and misses
- Verify cache eviction

**For scheduled/async tasks**:

- Use skill: `unit-test-scheduled-async`
- Test scheduling logic
- Test async execution

**For security/authorization**:

- Use skill: `unit-test-security-authorization`
- Test access control
- Test authentication flows

**For external API clients**:

- Use skill: `unit-test-wiremock-rest-api`
- Mock HTTP responses with WireMock
- Test retry logic and error handling

### 3. Generate Test Class Structure

Create a test class following these conventions:

```java
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.extension.ExtendWith;
import org.mockito.InjectMocks;
import org.mockito.Mock;
import org.mockito.junit.jupiter.MockitoExtension;

import static org.mockito.Mockito.*;
import static org.assertj.core.api.Assertions.*;

@ExtendWith(MockitoExtension.class) class [ClassName]

Test {

    @Mock
    private [Dependency]dependency;

    @InjectMocks
    private [ClassName]classUnderTest;

    // Test methods here
}
```

### 4. Generate Test Methods

For each public method, create tests covering:

**Happy path**:

```java

@Test
void shouldReturnExpectedResult_whenValidInput() {
    // Arrange
    when(dependency.method()).thenReturn(expectedValue);

    // Act
    var result = classUnderTest.methodUnderTest(input);

    // Assert
    assertThat(result).isNotNull();
    assertThat(result.getField()).isEqualTo(expectedValue);
    verify(dependency).method();
}
```

**Edge cases** (use skill: `unit-test-boundary-conditions`):

```java

@Test
void shouldHandleNullInput() {
    assertThatThrownBy(() -> classUnderTest.method(null))
            .isInstanceOf(IllegalArgumentException.class)
            .hasMessageContaining("must not be null");
}

@Test
void shouldHandleEmptyCollection() {
    var result = classUnderTest.method(List.of());
    assertThat(result).isEmpty();
}
```

**Exception scenarios**:

```java

@Test
void shouldThrowException_whenDependencyFails() {
    when(dependency.method()).thenThrow(new RuntimeException("Error"));

    assertThatThrownBy(() -> classUnderTest.methodUnderTest())
            .isInstanceOf(ServiceException.class)
            .hasRootCauseInstanceOf(RuntimeException.class);
}
```

**Parameterized tests** (use skill: `unit-test-parameterized`):

```java

@ParameterizedTest
@ValueSource(strings = {"valid1", "valid2", "valid3"})
void shouldAcceptValidInput(String input) {
    var result = classUnderTest.validate(input);
    assertThat(result).isTrue();
}
```

### 5. Follow Best Practices

- **Naming**: Use descriptive test method names (should...When... pattern)
- **AAA Pattern**: Arrange, Act, Assert clearly separated
- **One assertion concept per test**: Test one behavior per method
- **Fast tests**: No database, no network, no file I/O (< 50ms per test)
- **Immutability**: Use final fields, records for test data
- **AssertJ fluency**: Use fluent assertions for readability
- **Verify interactions**: Use verify() to check mock interactions
- **No magic values**: Use constants or factory methods for test data

### 6. Generate Complete Test File

Create the complete test file at the correct location:

- If source is `src/main/java/com/example/UserService.java`
- Test goes to `src/test/java/com/example/UserServiceTest.java`

Include:

- All necessary imports
- MockitoExtension configuration
- Mock and InjectMocks declarations
- All test methods
- Helper methods if needed

### 7. Verify Test Quality

After generating tests:

- Ensure all public methods are covered
- Check edge cases are tested
- Verify no hardcoded values
- Confirm no Spring context is loaded
- Run tests with: `mvn test -Dtest=[ClassName]Test`

## Available JUnit Skills Reference

Leverage these skills for specific scenarios:

- `unit-test-application-events` - Testing Spring application events
- `unit-test-bean-validation` - Testing Jakarta Bean Validation
- `unit-test-boundary-conditions` - Edge cases and boundary testing
- `unit-test-caching` - Testing cache behaviors
- `unit-test-config-properties` - Testing @ConfigurationProperties
- `unit-test-controller-layer` - Testing REST controllers
- `unit-test-exception-handler` - Testing exception handlers
- `unit-test-json-serialization` - Testing JSON serialization
- `unit-test-mapper-converter` - Testing mappers and converters
- `unit-test-parameterized` - Parameterized testing patterns
- `unit-test-scheduled-async` - Testing scheduled/async tasks
- `unit-test-security-authorization` - Testing security
- `unit-test-service-layer` - Testing service layer with Mockito
- `unit-test-utility-methods` - Testing utility classes
- `unit-test-wiremock-rest-api` - Testing external APIs with WireMock

## Examples

```bash
/developer-kit-java:devkit.java.write-unit-tests src/main/java/com/example/service/UserService.java
```

This will analyze UserService.java, identify it as a @Service class, apply the service-layer testing strategy, and
generate a comprehensive UserServiceTest.java with all necessary test cases.

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

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

Все слэш-команды по теме «Тесты и QA» →
java-testing pluginagentmarketplace Скилл java-testing генерирует модульные и интеграционные тесты для приложений на Java. Помогает настроить проверки с JUnit 5, Mockito, AssertJ и Testcontainers по практикам TDD. CX Codex +1 917установок 421-frameworks-quarkus-testing-unit-tests Juan Antonio Breña Moral Скилл 421-frameworks-quarkus-testing-unit-tests помогает писать быстрые модульные тесты для Quarkus через Mockito, REST Assured и параметризацию. Сокращает время прогона за счёт отказа от лишнего запуска контейнера. CX Codex +1 337установок 321-frameworks-spring-boot-testing-unit-tests Juan Antonio Breña Moral Скилл 321-frameworks-spring-boot-testing-unit-tests для Claude Code и других агентов: юнит-тесты Spring Boot с Mockito, срезы для контроллеров, параметризованные тесты — без поднятия контекста. Режет @SpringBootTest в проекте. CX Codex +1 413установок java-junit официальный github Скилл java-junit пишет, проверяет и исправляет Java-тесты на JUnit, AssertJ и Mockito. Нужен при добавлении, рефакторинге или разборе падений тестов в Maven и Gradle. CX Codex +1 11 632установок java Mindrally Задаёт агенту правила Java-разработки: слоистая структура, Spring Boot 3.x, тесты на JUnit и Mockito. Держит код в одном стиле по мере роста проекта. CX Codex +1 1 000установок spring-boot-testing официальный github Скилл spring-boot-testing подбирает способ тестирования Spring Boot: от JUnit-тестов и test slices до интеграции с Testcontainers. Учитывает различия Spring Boot 3 и 4. CX Codex +1 2 000установок

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

Весь набор →
nestjs-testing Правило nestjs-testing для NestJS-проектов: тестирует сервисы через TestingModule, мокирует зависимости Jest и пишет E2E-тесты с Supertest. Нужно, чтобы тесты не вызывали реальные API и БД. CX Codex +1 ★ 372звёзд репо nestjs-database-expert Субагент nestjs-database-expert для Claude Code помогает проектировать базы данных в NestJS: настраивает Drizzle ORM, генерирует миграции и пишет типизированные запросы. CX Codex ★ 372звёзд репо devkit.verify-skill Команда devkit.verify-skill проверяет скилл по требованиям DevKit, структуре шаблона и зависимостям. Запустите команду перед публикацией или после изменений. CX Codex +1 ★ 372звёзд репо aws-cloudformation-dynamodb Скилл aws-cloudformation-dynamodb для Claude Code даёт шаблоны CloudFormation для таблиц DynamoDB: ключи, индексы, режимы ёмкости, TTL и стримы. Описывает инфраструктуру кодом. CX Codex +1 ★ 372звёзд репо clean-architecture Помогает проектировать слои Clean Architecture, DDD и Hexagonal Architecture в приложениях NestJS на TypeScript. Пригодится при создании доменной модели или разборе тесно связанного MVC-кода. CX Codex +1 ★ 372звёзд репо spring-boot-backend-development-expert Субагент spring-boot-backend-development-expert для Claude по бэкенду на Spring Boot: реализует фичи, раскладывает код по Clean Architecture и пишет тесты к тому, что сделал. CX Codex ★ 372звёзд репо java-security-expert Субагент java-security-expert проводит аудит безопасности Java и Spring Boot: находит уязвимости по OWASP Top 10, проверяет OAuth2 и настраивает DevSecOps-пайплайны. CX Codex ★ 372звёзд репо general-code-reviewer Субагент general-code-reviewer проверяет изменения на ошибки, уязвимости и проблемы качества, а в отчёт включает только находки с уверенностью не ниже 80%. CX Codex ★ 372звёзд репо

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

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