# swift-architecture-skill

Помогает выбрать и применить архитектуру для SwiftUI или UIKit: от новой функции до рефакторинга и ревью кода.

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

## Что делает

Скилл подбирает плейбук для MVVM, MVI, TCA, Clean Architecture, VIPER, MVP, Coordinator и реактивных паттернов. Перед рекомендацией он учитывает задачу, UI-стек, минимальную версию iOS, масштаб изменений, сложность состояния и принятые в проекте соглашения.

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

Асинхронный код должен включать отмену и обработку ошибок. Это повод проверить минимальную версию iOS: для iOS 17+ скилл ориентирует на `@Observable`, а для iOS 16 — на `ObservableObject`. Новую зависимость вроде TCA он не предлагает без согласия на этот компромисс или уже существующего использования в кодовой базе.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add efremidze/swift-architecture-skill --skill swift-architecture-skill -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add efremidze/swift-architecture-skill --skill swift-architecture-skill -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add efremidze/swift-architecture-skill --skill swift-architecture-skill -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install efremidze/swift-architecture-skill swift-architecture-skill
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add efremidze/swift-architecture-skill --skill swift-architecture-skill -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/efremidze/swift-architecture-skill --path swift-architecture-skill
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add efremidze/swift-architecture-skill --skill swift-architecture-skill -a opencode
```

### Claude.ai

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

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

## Когда брать
- выбрать архитектуру для функции на SwiftUI
- проверить соответствие MVVM условиям проекта
- спланировать миграцию между архитектурными подходами
- разделить ответственность Coordinator и основного паттерна
- найти нарушения архитектуры в PR

## Примеры запросов агенту
- Подбери архитектуру для нового экрана SwiftUI с состоянием и асинхронной загрузкой.
- Проверь, подходит ли MVVM для этого UIKit-модуля, и предложи структуру файлов.
- Составь поэтапный план перехода с MVP на Clean Architecture для нескольких экранов.

## Похожие
- [ios-swift-development](https://affpapa.org/nevibecode/skills/ios-swift-development.md) — скилл · 1500 установок
- [ios-dev](https://affpapa.org/nevibecode/skills/ios-dev.md) — скилл · 697 установок
- [iphone-duo-readiness](https://affpapa.org/nevibecode/skills/iphone-duo-readiness.md) — скилл · 630 установок
- [swift-formatstyle](https://affpapa.org/nevibecode/skills/swift-formatstyle.md) — скилл · 2700 установок
- [swift-expert](https://affpapa.org/nevibecode/agents/swift-expert.md) — субагент · 378 установок
- [swiftui-development](https://affpapa.org/nevibecode/skills/swiftui-development.md) — скилл · 676 установок

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

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