# swift-expert

Субагент swift-expert для Swift-задач на iOS и macOS. Берёт производственный код как контракт, не чек-лист: анализирует границы исполнения, находит причину ошибки, внедряет минимальное изменение и проверяет, что оно не сломает остальное.

- субагент · `type=agent` · Codex, Claude Code, Cursor · ★ 6505 у репозитория
- Автор: VoltAgent
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/VoltAgent/awesome-codex-subagents/tree/HEAD/categories/02-language-specialists/swift-expert.toml
- Обновлён: 2026-10-05
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/voltagent-swift-expert

## Что делает

swift-expert работает с async/await, API Apple, strongly typed логикой и долгоживущими объектами. Сначала отображает точную границу исполнения (точка входа, путь данных, внешние зависимости), потом ищет корень проблемы или промежуток в дизайне, затем внедряет одно согласованное изменение, которое не трогает код вне области.

Проверяет value/reference семантику, actor isolation, синхронизацию состояния между UIKit и SwiftUI, error propagation, версионную совместимость SDK. Для каждого изменения валидирует три пути: успех, отказ и отмена операции, проверяет гонку данных, крахи в декодировании и optionals, убеждается, что UI обновляется в правильном контексте.

Возвращает модуль и границу, которые анализировал; конкретную проблему и причину; минимальное исправление с обоснованием трейд-офа; что тестировал локально и что ещё нужно проверить в среде; остаточный риск и следующие шаги.

## Установка

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

**Вручную: положить файлы**
- Файл: `.codex/agents/swift-expert.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Claude Code

**Вручную: положить файлы**
- Файл: `.claude/agents/swift-expert.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/VoltAgent/awesome-codex-subagents/tree/HEAD/categories/02-language-specialists/swift-expert.toml

## Когда брать
- исправить data race в async операциях между actor границами
- синхронизировать состояние UI при переходах между UIKit и SwiftUI
- уточнить версионные ограничения API Apple и обработать fallback
- отследить утечки памяти в долгоживущих объектах и observers
- валидировать error propagation и recoverability в flow приложения

## Примеры запросов агенту
- Проверь, почему async task в viewModel не отменяется при деинициализации и как это может привести к краху.
- Есть UIViewController с Combine publisher, который обновляет SwiftUI-представление — найди data race между потоками и предложи миграцию на actor.
- Анализируй границу между REST API клиентом и CoreData: какие optionals и версионные допущения могут привести к краху при декодировании.

## Похожие
- [guide-swift-concurrency](https://affpapa.org/nevibecode/skills/guide-swift-concurrency.md) — скилл · 539 установок
- [swift-modernizer](https://affpapa.org/nevibecode/agents/swift-modernizer.md) — субагент · ★ 233 у репозитория
- [swift-concurrency](https://affpapa.org/nevibecode/skills/wendylabsinc-swift-concurrency.md) — скилл · ★ 64 у репозитория
- [swift](https://affpapa.org/nevibecode/skills/margelo-swift.md) — скилл · 1300 установок
- [swift-development](https://affpapa.org/nevibecode/skills/swift-development.md) — скилл · 520 установок
- [axiom-concurrency](https://affpapa.org/nevibecode/skills/axiom-concurrency.md) — скилл · 1400 установок

## Другие версии с тем же именем
- [swift-expert · voltagent](https://affpapa.org/nevibecode/agents/swift-expert.md) — 378 установок
- [swift-expert · 0xfurai](https://affpapa.org/nevibecode/agents/0xfurai-swift-expert.md) — ★ 1029 у репозитория

Из того же набора: [voltagent/awesome-codex-subagents](https://affpapa.org/nevibecode/by/voltagent/awesome-codex-subagents.md) — 176 карточек

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

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