swift-modernizer — субагент для Claude Code: миграция Swift
Субагент swift-modernizer находит устаревшие конструкции Swift и переносит их на async/await, современные API и SwiftUI. Он пригодится при поэтапной модернизации старого кода.
MIT ★ 233 обновлён 2026-01-18
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineeringЧто делает 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-engineering2Вручную: положить файлы
.claude/agents/swift-modernizer.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/swift-modernizer.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/swift-modernizer.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты 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