# langchain4j-testing-strategies

Помогает тестировать Java-приложения на LangChain4j: от моков ChatModel до RAG-пайплайнов и интеграции с Testcontainers.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3700 установок · ★ 363
- Автор: giuseppe-trisciuoglio
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-java/skills/langchain4j-testing-strategies/SKILL.md
- Обновлён: 2026-09-10
- HTML: https://affpapa.org/nevibecode/skills/langchain4j-testing-strategies

## Что делает

Скилл подсказывает, как строить модульные тесты с моками `ChatModel`, проверять `AiServices`, retrieval chains, RAG-сценарии и вызовы инструментов. Для зависимостей рассматривает `langchain4j-test`, `testcontainers`, `mockito` и `assertj`, а для интеграционных проверок показывает подход с реальными сервисами в контейнерах.

Внутри есть отдельные материалы по модульным и интеграционным тестам, потоковой выдаче, памяти, обработке ошибок и тестовой пирамиде. Для внешних моделей советует сначала проверить здоровье контейнера и ответ модели, а в модульных тестах не обращаться к реальным API. Интеграционные тесты требуют Docker, поэтому это повод проверить локальный Docker daemon до настройки сценариев.

Скилл рассчитан на Java-код с LangChain4j и подходит для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add giuseppe-trisciuoglio/developer-kit --skill langchain4j-testing-strategies -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/langchain4j-testing-strategies/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/langchain4j-testing-strategies/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add giuseppe-trisciuoglio/developer-kit --skill langchain4j-testing-strategies -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/langchain4j-testing-strategies/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add giuseppe-trisciuoglio/developer-kit --skill langchain4j-testing-strategies -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/langchain4j-testing-strategies/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install giuseppe-trisciuoglio/developer-kit langchain4j-testing-strategies
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/langchain4j-testing-strategies/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add giuseppe-trisciuoglio/developer-kit --skill langchain4j-testing-strategies -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/giuseppe-trisciuoglio/developer-kit --path plugins/developer-kit-java/skills/langchain4j-testing-strategies
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/langchain4j-testing-strategies/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add giuseppe-trisciuoglio/developer-kit --skill langchain4j-testing-strategies -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/giuseppe-trisciuoglio/developer-kit/tree/HEAD/plugins/developer-kit-java/skills/langchain4j-testing-strategies/SKILL.md

## Когда брать
- замокать ответы ChatModel в модульных тестах
- проверить работу `AiServices` без внешнего API
- протестировать retrieval chains и RAG-сценарии
- запустить интеграционные тесты через Testcontainers
- проверить обработку ошибок и граничные случаи

## Примеры запросов агенту
- Настрой модульный тест для `AiServices` с моком `ChatModel` и детерминированным ответом.
- Собери интеграционный тест RAG с `OllamaChatModel`, `OllamaEmbeddingModel` и Testcontainers.
- Добавь проверки ошибок, тайм-аутов и готовности контейнера в тесты LangChain4j.

## Похожие
- [130-java-testing-strategies](https://affpapa.org/nevibecode/skills/130-java-testing-strategies.md) — скилл · 377 установок
- [java-testing-advanced](https://affpapa.org/nevibecode/skills/java-testing-advanced.md) — скилл · 328 установок
- [golang-testing-strategies](https://affpapa.org/nevibecode/skills/golang-testing-strategies.md) — скилл · 443 установки
- [csharp-testing](https://affpapa.org/nevibecode/skills/csharp-testing.md) — скилл · 4500 установок
- [322-frameworks-spring-boot-testing-integration-tests](https://affpapa.org/nevibecode/skills/322-frameworks-spring-boot-testing-integration-tests.md) — скилл · 357 установок
- [ai-system-testing](https://affpapa.org/nevibecode/skills/ai-system-testing.md) — скилл · 1100 установок

Из того же набора: [giuseppe-trisciuoglio/developer-kit](https://affpapa.org/nevibecode/by/giuseppe-trisciuoglio/developer-kit.md) — 93 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md