# akka-net-aspire-configuration

Скилл помогает связать Akka.NET и .NET Aspire: актор-система, кластер, персистентность и Akka.Management в одном проекте.

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

## Что делает

Скилл включается, когда вы поднимаете новый проект на Akka.NET с оркестрацией через .NET Aspire, настраиваете Akka.Cluster с бутстрапом и обнаружением узлов, подключаете Akka.Persistence к SQL Server или готовите деплой в Kubernetes. Он же пригодится при настройке нескольких реплик актор-системы в локальной разработке.

Внутри — структура решения из трёх проектов: акторы, веб-приложение и AppHost. Конфигурация идёт через Microsoft.Extensions.Configuration со строго типизированным классом `AkkaSettings`, DI-интеграция — через Akka.Hosting, а зависимости, сеть и переменные окружения берёт на себя Aspire. Отдельно описаны health checks для кластеризации, персистентности и готовности сервиса, плюс валидация настроек на старте через `IValidateOptions<T>` и `.ValidateOnStart()` — так опечатка в конфиге валит приложение сразу, а не через час в рантайме. Скилл ссылается на соседние: `akka-net-management`, `microsoft-extensions-configuration`, `akka-net-best-practices` и `aspire-integration-testing`.

Список NuGet-пакетов в скилле длинный: `Akka.Hosting`, `Akka.Cluster.Hosting`, `Akka.Persistence.Sql.Hosting`, `Akka.Management`, `Akka.Management.Cluster.Bootstrap`, провайдеры обнаружения для Kubernetes, Azure и Config, а также `Petabridge.Cmd.Host` и `Petabridge.Cmd.Cluster`. Без них примеры кода не соберутся, поэтому проверьте, что версии пакетов у вас согласованы.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- поднять актор-систему Akka.NET в новом проекте с Aspire
- настроить Akka.Cluster с бутстрапом и обнаружением узлов
- подключить Akka.Persistence к SQL Server
- запустить несколько реплик актор-системы локально
- вынести конфигурацию Akka в строго типизированный класс с валидацией на старте

## Примеры запросов агенту
- помоги настроить Akka.NET с Aspire для нового проекта
- добавь health checks для кластеризации и персистентности Akka
- собери AppHost с Akka.Management и бутстрапом кластера

## Похожие
- [aspire](https://affpapa.org/nevibecode/skills/aspire.md) — скилл · 2800 установок
- [aspire-monitoring](https://affpapa.org/nevibecode/skills/aspire-monitoring.md) — скилл · 1100 установок
- [aspire-deployment](https://affpapa.org/nevibecode/skills/aspire-deployment.md) — скилл · 616 установок
- [configuration](https://affpapa.org/nevibecode/skills/configuration.md) — скилл · 2800 установок
- [.NET Upgrade](https://affpapa.org/nevibecode/agents/net-upgrade.md) — субагент · ★ 40418
- [dotnet-fullstack-mentor](https://affpapa.org/nevibecode/agents/dotnet-fullstack-mentor.md) — субагент · ★ 40418

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

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