К основному содержанию
субагент CX Codex

swift-expert · voltagent/awesome-codex-subagents — субагент для Codex: iOS и macOS разработка

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

MIT ★ 6 505 обновлён 2026-10-05

Установить в Codex · Вручную: положить файлы Все способы и платформы ↓
.codex/agents/swift-expert.toml
Открыть на GitHub

Что делает swift-expert

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

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

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

Какие задачи решает

  • исправить 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 и версионные допущения могут привести к краху при декодировании.

Как установить swift-expert

Вручную: положить файлы

.codex/agents/swift-expert.toml

Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст

Вопросы о swift-expert

Как установить swift-expert в Codex?

Добавь файл конфига .codex/agents/swift-expert.toml в корень проекта. Структура зависит от версии Codex; смотри документацию платформы по подключению собственных субагентов.

Когда использовать swift-expert вместо обычного помощника?

Когда нужно разобраться с async/await, actor isolation, memory lifecycle, SDK версионной совместимостью или синхронизацией состояния между UIKit и SwiftUI — то есть когда требуется анализ границ исполнения и конкретного риска, а не код по шаблону.

Что делает swift-expert, если я просто скопирую код из Stack Overflow?

Не просто вставит его. Отобразит границу исполнения (где берёт данные, какие зависимости), найдёт риск для твоей архитектуры (утечка памяти, data race, отсутствие error handling) и предложит минимальное изменение, которое сохранит текущий стиль кода.

Исходный текст

swift-expert.toml · MIT
# swift-expert

Use when a task needs Swift expertise for iOS or macOS code, async flows, Apple platform APIs, or strongly typed application logic.

Own Swift tasks as production behavior and contract work, not checklist execution.

Prioritize smallest safe changes that preserve established architecture, and make explicit where compatibility or environment assumptions still need verification.

Working mode:
1. Map the exact execution boundary (entry point, state/data path, and external dependencies).
2. Identify root cause or design gap in that boundary before proposing changes.
3. Implement or recommend the smallest coherent fix that preserves existing behavior outside scope.
4. Validate the changed path, one failure mode, and one integration boundary.

Focus on:
- value/reference semantics and data ownership clarity
- async/await and actor isolation correctness
- UI state synchronization for UIKit/SwiftUI boundaries
- error propagation and recoverability in app flows
- API/SDK integration boundaries and version compatibility
- memory and lifecycle behavior in long-lived objects
- keeping code idiomatic to existing app architecture

Quality checks:
- verify changed behavior under success, failure, and cancellation states
- confirm actor/concurrency boundaries avoid data races
- check optionals and decoding assumptions for runtime crashes
- ensure UI updates occur on the correct execution context
- call out device/OS-version checks needed outside local workspace

Return:
- exact module/path and execution boundary you analyzed or changed
- concrete issue observed (or likely risk) and why it happens
- smallest safe fix/recommendation and tradeoff rationale
- what you validated directly and what still needs environment-level validation
- residual risk, compatibility notes, and targeted follow-up actions

Do not introduce broad architecture rewrites for localized defects unless explicitly requested by the parent agent.

© VoltAgent · MIT · VoltAgent/awesome-codex-subagents

Похожие субагенты

Все субагенты по теме «Мобильная разработка» →

Сначала — swift-expert от других авторов.

swift-expert VoltAgent Community Субагент swift-expert помогает разрабатывать Swift-приложения для iOS, macOS и серверного Swift. Подходит для SwiftUI, async/await, акторов и проверки управления памятью. CX Codex 378установок swift-expert 0xfurai Субагент swift-expert для Claude Code пишет и ревьюит Swift-код, включая SwiftUI, async/await, акторы и ARC, а также разбирает код и готовит тесты XCTest. CX Codex ★ 1 029звёзд репо guide-swift-concurrency Prisma-Labs-Dev Скилл guide-swift-concurrency настраивает проверку конкурентного кода на Swift 6.2 со strict concurrency. Он помогает находить гонки данных, изолировать акторы и заменять вызовы GCD на группы задач. CX Codex +1 539установок swift-modernizer John Rogers (@johnrogers) Субагент swift-modernizer находит устаревшие конструкции Swift и переносит их на async/await, современные API и SwiftUI. Он пригодится при поэтапной модернизации старого кода. CX Codex ★ 233звёзд репо swift-concurrency wendylabsinc Скилл swift-concurrency направляет агента при настройке async/await, акторов и миграции на Swift 6. Помогает устранять гонки данных без бездумного навешивания @MainActor. CX Codex +1 ★ 64звёзд репо swift margelo Дизайн типов, конкурентность и интеграция с Apple-платформами. Включается при правках .swift-файлов, async/await, DispatchQueue или Nitro Modules. CX Codex +1 1 300установок swift-development rshankras Скилл swift-development разбирает конкурентность, память и размер Swift-кода: подскажет, как перейти на строгую модель Swift 6 и убрать лишние аллокации. CX Codex +1 520установок axiom-concurrency CharlesWiltgen Скилл axiom-concurrency для работы с конкурентностью в приложениях на платформах Apple: акторы, @MainActor, Sendable, гонки данных. CX Codex +1 1 400установок

Из того же набора176

Весь набор →
azure-infra-engineer Субагент azure-infra-engineer проверяет и меняет инфраструктуру Azure с учётом безопасности, надёжности и отката. Поручите ему разбор ресурсов, сетей, доступа или автоматизации. CX Codex ★ 6 505звёзд репо vue-expert Субагент vue-expert для решения проблем с компонентами Vue, реактивностью и состоянием. Анализирует границы выполнения кода и предлагает минимальные безопасные исправления, сохраняя архитектуру проекта. CX Codex ★ 6 505звёзд репо typescript-pro Субагент typescript-pro для Codex, который правит типы, интерфейсы и ошибки компилятора TypeScript без лишних правок в чужом коде. CX Codex ★ 6 505звёзд репо symfony-specialist Субагент symfony-specialist разбирает Symfony-задачи: маршруты, контроллеры, сервисы, Doctrine и безопасность. Подключайте его для точечных изменений в существующем приложении. CX Codex ★ 6 505звёзд репо sql-pro Субагент sql-pro проектирует и проверяет SQL-запросы, отлаживает ошибки с учётом схемы и оценивает безопасность миграций баз данных. CX Codex ★ 6 505звёзд репо spring-boot-engineer Субагент spring-boot-engineer для задач на Spring Boot: конфигурация, слои данных, API, транзакции и безопасность. Анализирует границы выполнения, находит корни проблем и предлагает минимальные безопасные изменения, сохраняя архитектуру. CX Codex ★ 6 505звёзд репо rust-engineer Субагент rust-engineer для Rust-задач с упором на корректность владения, lifetime и async-поведение. Подходит для системного кода, где ошибка в заимствовании или синхронизации стоит дорого. CX Codex ★ 6 505звёзд репо react-specialist Субагент react-specialist для отладки компонентов React, потоков состояния и багов рендера. Находит причину сбоя и вносит минимальные безопасные правки. CX Codex ★ 6 505звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой