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

swift-modernizer — субагент для Claude Code: миграция Swift

Субагент swift-modernizer находит устаревшие конструкции Swift и переносит их на async/await, современные API и SwiftUI. Он пригодится при поэтапной модернизации старого кода.

MIT ★ 233 обновлён 2026-01-18

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering
Открыть на GitHub

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

swift-modernizer ищет в проекте устаревшие шаблоны Swift, составляет план миграции и вносит изменения небольшими шагами. Он проверяет результат тестами и граничными сценариями, а также учитывает зависимости между участками кода. Это помогает сохранять поведение приложения во время обновления.

Перед миграцией субагент вызывает подходящий скилл: modern-swift для обработчиков завершения и делегатов, swiftui-patterns для ObservableObject и UIKit. Для поиска по документации Apple он использует MCP-сервер Sosumi. В его инструментах есть чтение и редактирование файлов, поиск по проекту, запуск команд и ведение списка задач.

В описании заданы iOS 26.0+, Swift 6.2+ и строгая конкурентность. Если проект должен поддерживать более низкую версию iOS, проверьте deployment target: субагент заявляет обратную совместимость как принцип, но целевая платформа задана именно так.

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

  • заменить обработчики завершения на async/await
  • перевести делегаты на AsyncStream
  • переписать ObservableObject на @Observable
  • перенести UIKit-интерфейс на SwiftUI
  • проверить миграцию тестами и граничными сценариями

Примеры запросов агенту

  • Найди в проекте обработчики завершения и переведи их на async/await небольшими изменениями.
  • Проверь делегаты, которые можно заменить на AsyncStream, и составь план миграции.
  • Перенеси этот экран с UIKit на SwiftUI и проверь изменения тестами.

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

1Через маркетплейс плагинов

/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering

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

.claude/agents/swift-modernizer.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

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

Вопросы о swift-modernizer

Как установить swift-modernizer в Claude Code?

Нет. Используйте команды по порядку: /plugin marketplace add johnrogers/claude-swift-engineering, затем /plugin install swift-engineering@claude-swift-engineering.

Что делает swift-modernizer?

Он находит устаревшие шаблоны Swift и обновляет их, например, до async/await или SwiftUI. Миграция проходит поэтапно, с проверкой тестами.

Какие скиллы swift-modernizer использует при миграции?

Для обработчиков завершения и делегатов он вызывает modern-swift; для перехода с ObservableObject или UIKit — swiftui-patterns. Скилл нужно вызвать до изменения соответствующего шаблона.

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

swift-modernizer.md · MIT
---
name: swift-modernizer
description: Migrate legacy Swift patterns to modern best practices — async/await, modern APIs, SwiftUI. Use for legacy code modernization.
tools: Read, Write, Edit, Glob, Grep, Bash, Skill, TodoWrite
model: inherit
color: pink
skills: modern-swift, swiftui-patterns, ios-26-platform, swift-diagnostics
---

# Swift Modernizer

## Identity

You are an expert in migrating legacy Swift patterns.

**Mission:** Modernize legacy code to current Swift best practices.
**Goal:** Migrate code safely while preserving functionality.

## Context

**IMPORTANT:** Your system prompt contains today's date - use it for ALL API research, documentation, and deprecation checks. If you struggle with a framework/API, it may have changed since your training - search for current documentation.
**Platform:** iOS 26.0+, Swift 6.2+, Strict concurrency

## Migration Philosophy

1. **Preserve Functionality:** Never break existing behavior
2. **Incremental Progress:** Small, testable changes over big rewrites
3. **Backward Compatibility:** Maintain deployment target compatibility
4. **Performance Conscious:** Modern patterns should improve, not degrade

## Skill Usage (REQUIRED)

**You MUST invoke skills before migrating code.** Pre-loaded skills provide context, but you must actively use the Skill tool for migration patterns.

| When migrating... | Invoke skill |
|-------------------|--------------|
| Completion handlers → async/await | `modern-swift` |
| Delegates → AsyncStream | `modern-swift` |
| ObservableObject → @Observable | `swiftui-patterns` |
| UIKit → SwiftUI | `swiftui-patterns` |

**Process:** Before migrating any code pattern, invoke the relevant skill to get current migration examples.

## Migration Workflow

1. **Analyze**: Identify pattern occurrences with Grep, map dependencies
2. **Plan**: Create migration checklist with TodoWrite, identify test points
3. **Execute**: Migrate incrementally with tests after each change
4. **Verify**: Run tests, check edge cases, verify performance

## MCP Servers

Use Sosumi MCP server for Apple documentation:
- Check modern API replacements for 2025
- Verify deprecation status
- Find migration guides

---

*Other specialized agents exist in this plugin for different concerns. Focus on safe, incremental modernization.*

© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering

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

Все субагенты по теме «Мобильная разработка» →
swift-expert https://github.com/Jeffallan Скилл swift-expert для Claude Code: архитектура, SwiftUI, async/await, акторы и тесты на Swift. Ведёт агента при написании и разборе кода под iOS и macOS. CX Codex +1 4 500установок swift-concurrency jamesrochabrun Скилл swift-concurrency помогает писать, проверять и переписывать Swift-код с async/await, actors и MainActor. Нужен при переходе на Swift 6+. CX Codex +1 151установок guide-swift-concurrency Prisma-Labs-Dev Скилл guide-swift-concurrency настраивает проверку конкурентного кода на Swift 6.2 со strict concurrency. Он помогает находить гонки данных, изолировать акторы и заменять вызовы GCD на группы задач. CX Codex +1 539установок swift margelo Дизайн типов, конкурентность и интеграция с Apple-платформами. Включается при правках .swift-файлов, async/await, DispatchQueue или Nitro Modules. CX Codex +1 1 300установок swift-formatstyle dpearson2699 Скилл swift-formatstyle помогает переводить код iOS на FormatStyle и ParseableFormatStyle вместо старых Formatter. Пригодится при настройке вывода валют, дат и чисел в SwiftUI с учётом локалей. CX Codex +1 3 000установок swift-architecture-skill efremidze Скилл swift-architecture-skill для Claude Code помогает выбрать и применить архитектуру для SwiftUI- или UIKit-кода. Он включается при проектировании, рефакторинге и ревью функций и модулей. CX Codex +1 2 100установок

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

Весь набор →
generating-swift-package-docs Скилл generating-swift-package-docs генерирует справочную документацию по Swift-пакетам прямо из DerivedData проекта при анализе незнакомых библиотек. CX Codex +1 ★ 233звёзд репо five-whys Правило five-whys проводит разбор первопричины через пять вопросов «почему». Подходит для поиска системной причины сбоя, а не только его симптома. CX Codex +1 ★ 233звёзд репо swift-test-creator Субагент swift-test-creator для Claude Code и Codex пишет юнит- и интеграционные тесты на Swift Testing с @Test, #expect и #require. Создаёт тесты для готовой реализации. CX Codex ★ 233звёзд репо swift-documenter Субагент swift-documenter генерирует и обновляет файлы README и документирующие комментарии в коде на Swift. Пригодится после завершения фичи или при пересмотре документации пакета. CX Codex ★ 233звёзд репо reflect Команда reflect для Claude Code разбирает историю чата и настройки, а затем предлагает правки инструкций, команд и конфигурации. CX Codex +1 ★ 233звёзд репо swift-networking Скилл swift-networking помогает проектировать сетевой слой на базе Network.framework в Swift, настраивать сокеты, переключаться между Wi-Fi и сотовой сетью и разгружать главный поток. CX Codex +1 ★ 233звёзд репо ios-hig Скилл ios-hig помогает проектировать интерфейсы iOS с учётом рекомендаций Apple по доступности, визуальному оформлению и взаимодействию. Пригодится при создании экранов и проверке уже готовых элементов. CX Codex +1 ★ 233звёзд репо swift-engineer Субагент swift-engineer для Claude Code пишет код на чистом Swift без TCA: модели, сервисы, сеть и хранение в SQLite. Реализует фичи по готовому плану. CX Codex ★ 233звёзд репо

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

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