# aspire-configuration

Учит AppHost переводить ресурсы Aspire в явные ключи конфигурации, чтобы код приложения не зависел от клиентов Aspire и service discovery.

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

## Что делает

Скилл задаёт правило: пакеты Aspire Hosting живут только в AppHost. Ресурсы вроде Postgres или контейнера MinIO связываются с настройками приложения через `WithEnvironment(...)`, и каждое значение попадает в конфиг явным ключом. Приложение читает только `IOptions<T>` или `Configuration`.

Зачем это нужно? Любое значение, которое AppHost подставил в dev-окружении, должно выставляться в продакшене обычной переменной окружения или файлом конфигурации, без Aspire. Поэтому непрозрачный service discovery и скрытые абстракции отпадают: их нечем заменить на боевом сервере.

Внутри — примеры для AppHost и для кода приложения, чек-лист «Do / Don’t» и раздел про feature-тoggles: переключатели держат в конфиге и прокидывают через AppHost и тестовые фикстуры. Для тестовых переопределений скилл отсылает к `skills/aspire/integration-testing/SKILL.md`. Если в проекте уже есть `AddServiceDiscovery` в приложении, это повод проверить, не придётся ли переписывать конфигурацию перед выкладкой.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

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

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

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

### Claude.ai

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

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

## Когда брать
- перевести ресурсы AppHost в явные ключи конфигурации
- убрать пакеты Aspire client и service discovery из кода приложения
- сделать продакшен-конфигурацию переносимой без Aspire
- связать настройки через `IOptions<T>` с валидацией
- пробросить переключатели dev/test без правок кода приложения

## Примеры запросов агенту
- Покажи, как связать Postgres из AppHost с конфигурацией приложения через явные ключи
- Проверь, что в проекте API нет ссылок на пакеты Aspire client и service discovery
- Добавь feature toggle для blob storage через `WithEnvironment` и конфиг AppHost

## Похожие
- [aspire](https://affpapa.org/nevibecode/skills/aspire.md) — скилл · 2800 установок
- [aspire-monitoring](https://affpapa.org/nevibecode/skills/aspire-monitoring.md) — скилл · 1100 установок
- [aspireify](https://affpapa.org/nevibecode/skills/aspireify.md) — скилл · 630 установок
- [configuration](https://affpapa.org/nevibecode/skills/configuration.md) — скилл · 2800 установок
- [microsoft-extensions-configuration](https://affpapa.org/nevibecode/skills/wshaddix-microsoft-extensions-configuration.md) — скилл · 525 установок
- [python-configuration](https://affpapa.org/nevibecode/skills/python-configuration.md) — скилл · 11508 установок

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

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

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