# type-design-performance

Скилл для проектирования типов .NET с оглядкой на производительность: запечатанные классы, readonly-структуры, отложенный перебор коллекций.

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

## Что делает

Скилл включается, когда вы проектируете новые типы и API, разбираете код на предмет просадок по скорости или выбираете между классом, структурой и записью. Он задаёт набор правил: запечатывать классы, если наследование не задумано, брать `readonly struct` для небольших неизменяемых значений, отдавать из границ API неизменяемые коллекции.

Внутри — разбор по пунктам с примерами на C#. Есть таблица, когда структура уместнее класса, отдельный блок про `ValueTask` против `Task` с тремя оговорками (не ждать дважды, не трогать `.Result` до завершения, в сомнительных случаях брать `Task`), и раздел про `Span<T>` и `Memory<T>` вместо `byte[]`. Про отложенный перебор сказано прямо: цепочка LINQ с промежуточным `ToList()` материализует коллекцию лишний раз.

Скилл не для каждого файла. Если у вас обычный CRUD без горячих путей, советы про девиртуализацию JIT и защитные копии структур ничего не изменят, а вот ревью типов усложнят. Ставьте его в проектах, где аллокации и лишние проходы по коллекциям уже видны в профайлере.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install Aaronontheweb/dotnet-skills csharp-type-design-performance
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add Aaronontheweb/dotnet-skills --skill csharp-type-design-performance -a opencode
```

### Claude.ai

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

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

## Когда брать
- выбрать между классом, структурой и записью для нового типа
- убрать лишнюю материализацию коллекции в цепочке LINQ
- найти защитные копии у изменяемых структур
- решить, где уместен `ValueTask`, а где хватит `Task`
- запечатать классы и записи, чтобы JIT мог девиртуализировать вызовы

## Примеры запросов агенту
- Проверь этот файл по правилам type-design-performance: где тут лишний ToList и незапечатанные классы?
- Спроектируй тип OrderId по скиллу type-design-performance
- Разбери этот async-код: где стоит заменить Task на ValueTask по скиллу type-design-performance?

## Похожие
- [analyzing-dotnet-performance](https://affpapa.org/nevibecode/skills/analyzing-dotnet-performance.md) — скилл · 4900 установок
- [dotnet-inspect-performance](https://affpapa.org/nevibecode/skills/dotnet-inspect-performance.md) — скилл · 411 установок
- [dotnet-design-pattern-review](https://affpapa.org/nevibecode/skills/dotnet-design-pattern-review.md) — скилл · 11609 установок
- [optimizing-ef-core-queries](https://affpapa.org/nevibecode/skills/optimizing-ef-core-queries.md) — скилл · 5700 установок
- [122-java-type-design](https://affpapa.org/nevibecode/skills/122-java-type-design.md) — скилл · 394 установки
- [performance-smell-detection](https://affpapa.org/nevibecode/skills/performance-smell-detection.md) — скилл · 310 установок

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

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