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

swift-development · sammcj — скилл для Claude Code: что делает и как установить

Скилл swift-development внедряет правила многопоточности Swift 6, проверку изоляции акторов и шаблоны чистого API для проектов под iOS и macOS.

Apache-2.0 ★ 173 обновлён 2026-10-24

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add sammcj/agentic-coding --skill swift-development -a claude-code
Открыть на GitHub

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

Скилл задаёт ассистенту правила проектирования кода под современные версии языка (включая Swift 6 и 6.2). В фокусе — переход на строгую модель проверки многопоточности с изоляцией областей памяти (SE-0414), правильная расстановка @MainActor во вьюхах и безопасность глобальных переменных по SE-0412. Он подсказывает, как избегать взаимных блокировок при совмещении DispatchSemaphore с async/await, и напоминает о регулярном вызове Task.checkCancellation() внутри циклов.

Внутрь также включены разборы неочевидных проблем AppKit и системных API. Например, описан обход бага окон настроек в строке меню через смену политики активации на .regular, а также предупреждение о потере миллисекунд: стандартная стратегия .iso8601 у JSONEncoder срезает доли секунд, поэтому для точного времени предложено настраивать кастомный форматтер.

Правила ориентированы на свежий стек и macOS 15.7+, поэтому для старых платформ предлагаемые решения могут потребовать правок доступности через @available.

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

  • перевести проект с Swift 5 на Swift 6 без скрытых гонок данных
  • настроить изоляцию состояния в акторах и разгрузить главный поток от лишних вызовов MainActor.run
  • починить поведение скрывающихся окон настроек в menu-bar приложениях macOS
  • исправить предупреждения компилятора вокруг Sendable и изолированных свойств

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

  • Проверь этот класс на ошибки изоляции акторов и перепиши под правила Swift 6
  • Сделай окно настроек для menu-bar утилиты на AppKit, чтобы оно не пряталось при клике мимо
  • Отрефактори вызовы API с async let и добавь проверку отмены долгих задач

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

1Через Skills CLI (Vercel)

npx skills add sammcj/agentic-coding --skill swift-development -a claude-code

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

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

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

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

Вопросы о swift-development

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

Выполните в терминале команду npx skills add sammcj/agentic-coding --skill swift-development -a claude-code. Файл правил сохранится по пути ~/.claude/skills/swift-development/SKILL.md.

Что делает скилл swift-development?

Он задаёт системные инструкции по стилю API, правилам именования, многопоточности Swift 6 и корректной работе с акторами в macOS и iOS.

Для каких версий систем рассчитаны эти правила?

Инструкции ориентированы на современные сборки Swift 6 и 6.2, а для приложений macOS базовой целью указана macOS 15.7+.

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

SKILL.md · Apache-2.0
---
name: swift-development
description: You MUST activate this skill when working on Swift projects
---

# Swift Best Practices Skill

## Overview

Apply modern Swift development best practices focusing on Swift 6+ features, concurrency safety, API design principles, and code quality guidelines for iOS and macOS projects targeting macOS 15.7+.

## When to Use This Skill

Use this skill when:
- Writing new Swift code for iOS or macOS applications
- Reviewing Swift code for correctness, safety, and style
- Implementing Swift concurrency features (async/await, actors, MainActor)
- Designing Swift APIs and public interfaces
- Migrating code from Swift 5 to Swift 6
- Addressing concurrency warnings, data race issues, or compiler errors related to Sendable/isolation
- Working with modern Swift language features introduced in Swift 6 and 6.2

## Core Guidelines

### Fundamental Principles

1. **Clarity at point of use** is paramount - evaluate designs by examining use cases, not just declarations
2. **Clarity over brevity** - compact code comes from the type system, not minimal characters
3. **Write documentation for every public declaration** - if you can't describe functionality simply, the API may be poorly designed
4. **Name by role, not type** - `var greeting = "Hello"` not `var string = "Hello"`
5. **Favour elegance through simplicity** - avoid over-engineering unless complexity genuinely warrants it

### Swift 6 Concurrency Model

Swift 6 enables complete concurrency checking by default with region-based isolation (SE-0414). The compiler now proves code safety, eliminating many false positives whilst catching real concurrency issues at compile time.

**Critical understanding:**
- **Async ≠ background** - async functions can suspend but don't automatically run on background threads
- Actors protect mutable shared state through automatic synchronisation
- `@MainActor` ensures UI-related code executes on the main thread
- Global actor-isolated types are automatically `Sendable`

### Essential Patterns

#### Async/Await
```swift
// Parallel execution with async let
func fetchData() async -> (String, Int) {
    async let stringData = fetchString()
    async let intData = fetchInt()
    return await (stringData, intData)
}

// Always check cancellation in long-running operations
func process(_ items: [Item]) async throws -> [Result] {
    var results: [Result] = []
    for item in items {
        try Task.checkCancellation()
        results.append(await process(item))
    }
    return results
}
```

#### MainActor for UI Code
```swift
// Apply at type level for consistent isolation
@MainActor
class ContentViewModel: ObservableObject {
    @Published var images: [UIImage] = []

    func fetchData() async throws {
        self.images = try await fetchImages()
    }
}

// Avoid MainActor.run when direct await works
await doMainActorStuff()  // Good
await MainActor.run { doMainActorStuff() }  // Unnecessary
```

#### Actor Isolation
```swift
actor DataCache {
    private var cache: [String: Data] = [:]

    func store(_ data: Data, forKey key: String) {
        cache[key] = data  // No await needed inside actor
    }

    nonisolated func cacheType() -> String {
        return "DataCache"  // No await needed - doesn't access isolated state
    }
}
```

### Common Pitfalls to Avoid

1. **Don't mark functions as `async` unnecessarily** - async calling convention has overhead
2. **Never use `DispatchSemaphore` with async/await** - risk of deadlock
3. **Don't create stateless actors** - use non-isolated async functions instead
4. **Avoid split isolation** - don't mix isolation domains within one type
5. **Check task cancellation** - long operations must check `Task.checkCancellation()`
6. **Don't assume async means background** - explicitly move work to background if needed
7. **Avoid excessive context switching** - group operations within same isolation domain

### AppKit Gotchas

**Menu-bar app windows open behind everything / hide on click-away.** Two separate causes, usually hit together:

- `.accessory` activation policy means the app is never brought forward when a window opens.
- SwiftUI's `Settings` scene is an `NSPanel`, which in an accessory app defaults to `hidesOnDeactivate = true`.

Fix both: switch to `.regular` while the window is open, clear `hidesOnDeactivate`, then revert on `NSWindow.willCloseNotification`.

```swift
NSApp.setActivationPolicy(.regular)
NSApp.activate()
openSettings()
DispatchQueue.main.async {          // window does not exist until SwiftUI opens it
    guard let w = NSApp.windows.first(where: {
        $0.identifier?.rawValue.hasPrefix("com_apple_SwiftUI_Settings") == true }) else { return }
    w.hidesOnDeactivate = false
    w.makeKeyAndOrderFront(nil)
    w.orderFrontRegardless()
}
// On willCloseNotification: NSApp.setActivationPolicy(.accessory)
```

Cost: a Dock icon while the window is open. `SettingsLink` cannot do this - it has no action hook, so use `@Environment(\.openSettings)`.

**`JSONEncoder.dateEncodingStrategy = .iso8601` truncates to whole seconds.** Silently breaks any sub-second timing logic. Use `.custom` with `ISO8601DateFormatter` + `.withFractionalSeconds`.

### API Design Quick Reference

#### Naming Conventions
- Types/protocols: `UpperCamelCase`
- Everything else: `lowerCamelCase`
- Protocols describing capabilities: `-able`, `-ible`, `-ing` suffixes (`Equatable`, `ProgressReporting`)
- Factory methods: Begin with `make` (`x.makeIterator()`)
- Mutating pairs: imperative vs past participle (`x.sort()` / `x.sorted()`)

#### Method Naming by Side Effects
- No side effects: Noun phrases (`x.distance(to: y)`)
- With side effects: Imperative verbs (`x.append(y)`, `x.sort()`)

#### Argument Labels
- Omit when arguments can't be distinguished: `min(number1, number2)`
- Value-preserving conversions omit first label: `Int64(someUInt32)`
- Prepositional phrases label at preposition: `x.removeBoxes(havingLength: 12)`
- Label all other arguments

### Swift 6 Breaking Changes

#### Must Explicitly Mark Types with @MainActor (SE-0401)
Property wrappers no longer infer actor isolation automatically.

```swift
@MainActor
struct LogInView: View {
    @StateObject private var model = ViewModel()
}
```

#### Global Variables Must Be Concurrency-Safe (SE-0412)
```swift
static let config = Config()  // Constant - OK
@MainActor static var state = State()  // Actor-isolated - OK
nonisolated(unsafe) var cache = [String: Data]()  // Unsafe - use with caution
```

#### Other Changes
- `@UIApplicationMain`/`@NSApplicationMain` deprecated (use `@main`)
- `any` required for existential types
- Import visibility requires explicit access control

### API Availability Patterns

```swift
// Basic availability
@available(macOS 15, iOS 18, *)
func modernAPI() { }

// Deprecation with message
@available(*, deprecated, message: "Use newMethod() instead")
func oldMethod() { }

// Renaming with auto-fix
@available(*, unavailable, renamed: "newMethod")
func oldMethod() { }

// Runtime checking
if #available(iOS 18, *) {
    // iOS 18+ code
}

// Inverted checking (Swift 5.6+)
if #unavailable(iOS 18, *) {
    // iOS 17 and lower
}
```

**Key differences:**
- `deprecated` - Warning, allows usage
- `obsoleted` - Error from specific version
- `unavailable` - Error, completely prevents usage

## How to Use This Skill

### When Writing Code

1. Apply naming conventions following role-based, clarity-first principles
2. Use appropriate isolation (`@MainActor` for UI, actors for mutable state)
3. Implement async/await patterns correctly with proper cancellation handling
4. Follow Swift 6 concurrency model - trust compiler's flow analysis
5. Document public APIs with clear, concise summaries

### When Reviewing Code

1. Check for concurrency safety violations
2. Verify proper actor isolation and Sendable conformance
3. Ensure async functions handle cancellation appropriately
4. Validate API naming follows Swift guidelines
5. Confirm availability annotations are correct for target platforms

### Code Quality Standards

- Minimise comments - code should be self-documenting where possible
- Avoid over-engineering and unnecessary abstractions
- Use meaningful variable names based on role, not type
- Follow established project architecture and patterns
- Prefer `count(where:)` over `filter().count`
- Use `InlineArray` for fixed-size, performance-critical data
- Trust compiler's concurrency flow analysis - avoid unnecessary `Sendable` conformances

## Resources

### references/

Detailed reference material to load when in-depth information is needed:

- **api-design.md** - Complete API design conventions, documentation standards, parameter guidelines, and naming patterns
- **concurrency.md** - Detailed async/await patterns, actor best practices, common pitfalls, performance considerations, and thread safety patterns
- **swift6-features.md** - New language features in Swift 6/6.2, breaking changes, migration strategies, and modern patterns
- **availability-patterns.md** - Comprehensive `@available` attribute usage, deprecation strategies, and platform version management

Load these references when detailed information is needed beyond the core guidelines provided above.

## Platform Requirements

- Swift 6.0+ compiler for Swift 6 features
- Swift 6.2+ for InlineArray and enhanced concurrency features
- macOS 15.7+ with appropriate SDK
- iOS 18+ for latest platform features
- Use `#available` for runtime platform detection
- Use `@available` for API availability marking

© sammcj · Apache-2.0 · sammcj/agentic-coding

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

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

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

swift-development rshankras Скилл swift-development разбирает конкурентность, память и размер Swift-кода: подскажет, как перейти на строгую модель Swift 6 и убрать лишние аллокации. CX Codex +1 520установок swift-expert VoltAgent Community Субагент swift-expert помогает разрабатывать Swift-приложения для iOS, macOS и серверного Swift. Подходит для SwiftUI, async/await, акторов и проверки управления памятью. CX Codex 378установок macos-development rshankras Скилл macos-development для разработки приложений под macOS: Swift 6+, SwiftUI, SwiftData, AppKit и API macOS 26 Tahoe. Пригодится на код-ревью и разборе архитектуры. CX Codex +1 1 600установок swift-concurrency dpearson2699 Скилл swift-concurrency помогает устранять ошибки Sendable и изоляции акторов в Swift 6.2+, настраивать фоновые задачи и применять SE-0466. CX Codex +1 4 600установок guide-swift-concurrency Prisma-Labs-Dev Скилл guide-swift-concurrency настраивает проверку конкурентного кода на Swift 6.2 со strict concurrency. Он помогает находить гонки данных, изолировать акторы и заменять вызовы GCD на группы задач. CX Codex +1 539установок swift-optimise pproenca Скилл swift-optimise разбирает производительность Swift и SwiftUI: конкуренцию, отрисовку и анимации. Нужен при профилировании clinic-модулей. CX Codex +1 293установок cmux-architecture manaflow-ai Скилл cmux-architecture задаёт правила разделения кода cmux на пакеты Swift, инверсии зависимостей и многопоточности Swift 6. Помогает переносить модули без циклических связей. CX Codex +1 5 100установок

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

Весь набор →
software-research-assistant Субагент software-research-assistant для Claude Code исследует библиотеки, фреймворки и API по документации, примерам кода и актуальным рекомендациям из источников. Помогает внедрить инструмент или выбрать между вариантами. CX Codex ★ 173звёзд репо guided-demo Скилл guided-demo добавляет в веб-приложения и HTML-страницы интерактивные демо с пошаговой подсветкой элементов и печатью текста. CX Codex +1 ★ 173звёзд репо diagnose-hard-problem Скилл diagnose-hard-problem для Claude Code ведёт агента через диагностику сложных багов: строит проверяемый цикл воспроизведения, сужает сценарий и проверяет гипотезы. Разбирает регрессии и нестабильные ошибки. CX Codex +1 ★ 173звёзд репо yue2-music Скилл yue2-music для Claude, который ведёт генерацию песни в YuE2 от запроса до готового аудио: режимы full, melody и off, каверы с расшифровкой через SheetSage2 и локальный плеер для сравнения дублей. CX Codex +1 ★ 173звёзд репо github-triage Скилл github-triage для Claude Code разбирает GitHub issues по меткам и состояниям и ведёт maintainer к решению. Разбирает баги и feature requests, готовит задачи агенту. CX Codex +1 ★ 173звёзд репо authoring-claude-md Скилл authoring-claude-md помогает создавать и поддерживать CLAUDE.md и файлы правил в .claude/rules/, которые хранят контекст проекта — архитектурные решения, нестандартные соглашения и решения проблем, с которыми ИИ встречается регулярно. CX Codex +1 ★ 173звёзд репо bento-slides Скилл bento-slides для Claude Code создаёт и редактирует презентации Bento в одном HTML-файле. Превращает данные, этапы процесса или код в слайды. CX Codex +1 ★ 173звёзд репо code-review-recent-changes Скилл code-review-recent-changes проверяет изменения в ветке по трём осям: стандарты репозитория, соответствие спеке и поддерживаемость кода. Каждая ось идёт отдельным субагентом, в конце — отчёт с вердиктом. CX Codex +1 ★ 173звёзд репо

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

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