# akka-net-testing-patterns

Скилл для написания юнит- и интеграционных тестов акторов Akka.NET на Akka.Hosting.TestKit: внедрение зависимостей, TestProbes, проверка персистентности.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 411 установок · ★ 1238
- Автор: Aaronontheweb
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/Aaronontheweb/dotnet-skills/tree/HEAD/skills/akka-testing-patterns/SKILL.md
- Обновлён: 2026-10-11
- HTML: https://affpapa.org/nevibecode/skills/akka-net-testing-patterns

## Что делает

Скилл описывает, как тестировать акторы Akka.NET через `Akka.Hosting.TestKit`. Внутри — восемь шаблонов с примерами кода: базовый тест актора, `TestProbe` для проверки обмена сообщениями, автоответчик для `Ask`, тесты персистентных акторов с event sourcing, переиспользование продакшн-конфигурации. Отдельный файл разбирает антипаттерны и традиционный `Akka.TestKit`.

Основной подход такой: класс теста наследуется от `Akka.Hosting.TestKit.TestKit`, переопределяет `ConfigureServices()` для подмены реальных сервисов фейками и `ConfigureAkka()` для регистрации акторов теми же extension-методами, что и в продакшне. Акторы достаются из `ActorRegistry` по типу. Для персистентности есть `WithInMemoryJournal()` и `WithInMemorySnapshotStore()`.

Есть нюанс, на котором легко споткнуться. `Akka.Hosting.TestKit` поднимает настоящие `IHost`, а те по умолчанию следят за файлами конфигурации. На сотне тестов это упирается в лимит inotify на Linux. Скилл советует добавить в тестовый проект `TestEnvironmentInitializer` с `[ModuleInitializer]`, который выставляет `DOTNET_HOSTBUILDER__RELOADCONFIGONCHANGE` в `false` до запуска тестов.

Из пакетов нужны `Akka.Hosting.TestKit`, `xunit` с раннером, `Microsoft.NET.Test.Sdk`, для проверок — `FluentAssertions`, для персистентности — `Akka.Persistence.Hosting`, для шардинга — `Akka.Cluster.Hosting`.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Aaronontheweb/dotnet-skills --skill akka-net-testing-patterns -a claude-code
```
```bash
npx skills add Aaronontheweb/dotnet-skills --skill akka-testing-patterns -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Aaronontheweb/dotnet-skills --skill akka-testing-patterns -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Aaronontheweb/dotnet-skills --skill akka-testing-patterns -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Aaronontheweb/dotnet-skills akka-testing-patterns
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add Aaronontheweb/dotnet-skills --skill akka-testing-patterns -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/Aaronontheweb/dotnet-skills --path skills/akka-testing-patterns
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Aaronontheweb/dotnet-skills --skill akka-testing-patterns -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/Aaronontheweb/dotnet-skills/tree/HEAD/skills/akka-testing-patterns/SKILL.md

## Когда брать
- написать юнит-тест актора с подменой репозитория на фейк
- проверить через TestProbe, что актор отправил нужное сообщение
- протестировать восстановление персистентного актора из журнала
- настроить автоответчик для актора, который общается с зависимостями через Ask
- переиспользовать продакшн-конфигурацию акторов в тестах вместо копии HOCON

## Примеры запросов агенту
- напиши тест для OrderActor по паттерну базового теста из akka-net-testing-patterns
- проверь через TestProbe, что актор шлёт событие в шину после создания заказа
- добавь TestEnvironmentInitializer в тестовый проект, чтобы тесты не падали на inotify

## Похожие
- [csharp-testing](https://affpapa.org/nevibecode/skills/csharp-testing.md) — скилл · 4500 установок
- [testing](https://affpapa.org/nevibecode/skills/codewithmukesh-testing.md) — скилл · 2800 установок
- [scaffold-dotnet-test-project](https://affpapa.org/nevibecode/skills/scaffold-dotnet-test-project.md) — скилл · 2600 установок
- [code-testing](https://affpapa.org/nevibecode/skills/code-testing.md) — скилл · 863 установки
- [dotnet-xunit](https://affpapa.org/nevibecode/skills/dotnet-xunit.md) — скилл · 613 установок
- [testing-patterns](https://affpapa.org/nevibecode/skills/testing-patterns.md) — скилл · 365 установок

Из того же набора: [aaronontheweb/dotnet-skills](https://affpapa.org/nevibecode/by/aaronontheweb/dotnet-skills.md) — 32 карточки

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