К основному содержанию
скилл CX Codex

modern-swift — скилл для Claude Code: async/await и strict concurrency

Скилл modern-swift для Claude, который ведёт агента при работе с конкурентностью в Swift 6.2: async/await, акторы, Sendable и отмена задач.

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

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

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

Скилл про конкурентность в Swift 6.2. Компилятор ловит гонки данных на этапе сборки: код, который собирается со strict concurrency, гонок не содержит. Внутри — правила перевода со старых приёмов (completion handlers, DispatchQueue, локи) на async/await, @MainActor и actor, плюс таблица «что использовать вместо чего».

Кроме шпаргалки, скилл велит агенту подгружать восемь справочных файлов из references/ — по TaskGroup, отмене задач, строгому режиму, макросам, миграции делегатов и UIKit. Есть разбор типовых ошибок: @unchecked Sendable вместо починки причины, забытый @MainActor на моделях экрана и главных тестовых структурах, сильная ссылка на self в долгой задаче, которая не даёт объекту освободиться.

Строгая проверка включается флагом в Package.swift. Без неё компилятор не станет искать гонки, так что гарантии скилла действуют только для целей, где режим включён.

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

  • Перевести загрузку данных с completion handlers на async/await
  • Включить strict concurrency в Package.swift и разобрать ошибки Sendable
  • Заменить лок на actor для общего изменяемого состояния
  • Запустить параллельные запросы через TaskGroup с проверкой отмены
  • Добавить @MainActor туда, где тесты и модели экрана трогают UI

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

  • Переведи этот сетевой слой с completion handlers на async/await и поставь @MainActor на модель экрана
  • Включи strict concurrency в Package.swift и пройди по каждой ошибке Sendable
  • Загрузи четыре ленты параллельно через TaskGroup и отменяй группу, если одна упала

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

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

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

Команда ставит плагин swift-engineering целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add johnrogers/claude-swift-engineering --skill modern-swift -a claude-code

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

~/.claude/skills/modern-swift/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/modern-swift/

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

Вопросы о modern-swift

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

Добавь маркетплейс командой /plugin marketplace add johnrogers/claude-swift-engineering, затем поставь плагин: /plugin install swift-engineering@claude-swift-engineering.

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

Подсказывает агенту, как писать конкурентный код на Swift 6.2: async/await, @MainActor, actor, TaskGroup и проверка отмены. Отдельно разбирает ошибки Sendable и типовые промахи вроде @unchecked Sendable.

Что внутри скилла, кроме основной инструкции?

Восемь справочных файлов в references/: конкурентность, Swift 6, группы задач, отмена, строгий режим, макросы, современные атрибуты и миграция старых паттернов. Скилл велит агенту подгружать нужный файл, как только появляется шанс, что пригодится.

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

SKILL.md · MIT
---
name: modern-swift
description: Use when writing async/await code, enabling strict concurrency, fixing Sendable errors, migrating from completion handlers, managing shared state with actors, or using Task/TaskGroup for concurrency.
---

# Modern Swift (6.2+)

Swift 6.2 introduces strict compile-time concurrency checking with async/await, actors, and Sendable constraints that prevent data races at compile time instead of runtime. This is the foundation of safe concurrent Swift.

## Overview

Modern Swift replaces older concurrency patterns (completion handlers, DispatchQueue, locks) with compiler-enforced safety. The core principle: if it compiles with strict concurrency enabled, it cannot have data races.

## Quick Reference

| Need | Use | NOT |
|------|-----|-----|
| Async operation | `async/await` | Completion handlers |
| Main thread work | `@MainActor` | `DispatchQueue.main` |
| Shared mutable state | `actor` | Locks, serial queues |
| Parallel tasks | `TaskGroup` | `DispatchGroup` |
| Thread safety | `Sendable` | `@unchecked` everywhere |

## Core Workflow

When writing async Swift code:
1. Mark async functions with `async`, call with `await`
2. Apply `@MainActor` to view models and UI-updating code
3. Use `actor` instead of locks for shared mutable state
4. Check `Task.isCancelled` or call `Task.checkCancellation()` in loops
5. Enable strict concurrency in Package.swift for compile-time safety

## Reference Loading Guide

**ALWAYS load reference files if there is even a small chance the content may be required.** It's better to have the context than to miss a pattern or make a mistake.

| Reference | Load When |
|-----------|-----------|
| **[Concurrency Essentials](references/concurrency-essentials.md)** | Writing async code, converting completion handlers, using `await` |
| **[Swift 6 Concurrency](references/swift6-concurrency.md)** | Using `@concurrent`, `nonisolated(unsafe)`, or actor patterns |
| **[Task Groups](references/task-groups.md)** | Running multiple async operations in parallel |
| **[Task Cancellation](references/task-cancellation.md)** | Implementing long-running or cancellable operations |
| **[Strict Concurrency](references/strict-concurrency.md)** | Enabling Swift 6 strict mode or fixing Sendable errors |
| **[Macros](references/macros.md)** | Using or understanding Swift macros like `@Observable` |
| **[Modern Attributes](references/modern-attributes.md)** | Migrating legacy code or using `@preconcurrency`, `@backDeployed` |
| **[Migration Patterns](references/migration-patterns.md)** | Modernizing delegate patterns or UIKit views |

## Common Mistakes

1. **`@unchecked Sendable` as a quick fix** — Using `@unchecked Sendable` to silence compiler errors means you've opted out of safety. If the error persists after `@unchecked`, your code has a potential data race. Fix the underlying issue instead.

2. **Missing `await` at call sites** — Forgetting `await` when calling async functions is a compiler error, but checking `Task.isCancelled` in a loop without calling `Task.checkCancellation()` silently ignores cancellation.

3. **Capturing `self` in async blocks without `weak`** — Holding a strong reference to `self` in a long-running async task prevents deinit. Always use `[weak self]` in closures or use `.task` which auto-manages the lifecycle.

4. **Not checking task cancellation** — Long-running operations should regularly check `Task.isCancelled` or call `Task.checkCancellation()`, otherwise cancellation signals are ignored.

5. **Forgetting `@MainActor` on UI code and test suites** — Main test struct and view models that update `@Published` properties need `@MainActor`. Forgetting it silently allows cross-thread mutations. Apply `@MainActor` to: view models, view structs, main test structs, and any type that touches UI.

6. **Actor re-entrancy surprises** — `await` inside an actor method can release the lock temporarily. Another task may modify actor state. Design actor methods assuming state can change between `await` points.

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

Похожие скиллы

Все скиллы по теме «Языки программирования» →
swift-concurrency dpearson2699 Скилл swift-concurrency помогает устранять ошибки Sendable и изоляции акторов в Swift 6.2+, настраивать фоновые задачи и применять SE-0466. CX Codex +1 4 600установок swift-concurrency-expert Dimillian Скилл swift-concurrency-expert проверяет и исправляет проблемы параллелизма в Swift 6.2+: добавляет Sendable, применяет @MainActor, решает предупреждения об изоляции акторов и переводит completion handlers на async/await. CX Codex +1 2 100установок swift-code-review existential-birds Скилл swift-code-review для Claude Code проверяет Swift-код на ошибки конкурентности, обработки ошибок и управления памятью. Подключается при ревью файлов .swift, в том числе с async/await, actors и Sendable. CX Codex +1 253установок guide-swift-concurrency Prisma-Labs-Dev Скилл guide-swift-concurrency настраивает проверку конкурентного кода на Swift 6.2 со strict concurrency. Он помогает находить гонки данных, изолировать акторы и заменять вызовы GCD на группы задач. CX Codex +1 539установок swift-expert https://github.com/Jeffallan Скилл swift-expert для Claude Code: архитектура, SwiftUI, async/await, акторы и тесты на Swift. Ведёт агента при написании и разборе кода под iOS и macOS. CX Codex +1 4 500установок

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

Весь набор →
foundation-models Подключает паттерны работы с Foundation Models Apple: суммаризацию, извлечение данных и классификацию текста на устройстве. Claude Code сверяется с ним при настройке LanguageModelSession и @Generable. CX Codex +1 ★ 233звёзд репо tca-engineer Субагент tca-engineer пишет код TCA-фичи по готовому дизайну: редьюсер, состояние, экшены и клиенты зависимостей с тестовыми реализациями. Вьюхи не трогает. CX Codex ★ 233звёзд репо sqlite-data Помогает проектировать базы данных на Swift с библиотекой SQLiteData, писать выборки через макросы и настраивать синхронизацию с CloudKit. CX Codex +1 ★ 233звёзд репо composable-architecture Скилл помогает строить функции на The Composable Architecture (TCA): организовывать редьюсеры, состояние, эффекты, навигацию и тесты. Пригодится при разработке или проверке TCA-функций. CX Codex +1 ★ 233звёзд репо swiftui-patterns Скилл swiftui-patterns внедряет архитектурные паттерны SwiftUI для iOS 17+: макрос @Observable, программную навигацию и связывание с UIKit. CX Codex +1 ★ 233звёзд репо swift-testing Скилл помогает писать тесты на Swift Testing, переносить проверки с XCTest и добавлять асинхронные и параметризованные сценарии. CX Codex +1 ★ 233звёзд репо tca-architect Субагент tca-architect проектирует архитектуру фич на The Composable Architecture: структуру State, таксономию Action, зависимости и навигацию. Работает в режиме read-only. CX Codex ★ 233звёзд репо swift-architect Субагент swift-architect планирует архитектуру новых фич на Swift, структуру файлов и слой хранения без изменения кода проекта. CX Codex ★ 233звёзд репо

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

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