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

swift-expert · personamanagmentlayer — скилл для Claude Code: Swift-разработка

Скилл swift-expert для Claude Code помогает писать и разбирать код на Swift для iOS и macOS. Охватывает задачи со SwiftUI, Combine и современным синтаксисом Swift.

Apache-2.0 163 установок ★ 45 обновлён 2026-10-12

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

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

Скилл даёт агенту рекомендации по Swift 5.9+, включая async/await, акторы, замыкания, протоколы и работу со значениями и ссылками. Он также охватывает SwiftUI: состояние экранов, композицию представлений, навигацию и анимации.

В примерах показаны модели представлений с Combine, сетевой клиент на URLSession и обработка JSON. Агенту разрешены инструменты Read, Write, Edit, а также запуск swift и xcodebuild; доступные действия ограничены этими инструментами.

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

  • собрать экран SwiftUI с управлением состоянием
  • написать асинхронный запрос к API на Swift
  • организовать поиск через Combine
  • разобраться с замыканиями, протоколами и типами Swift

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

  • Собери экран профиля на SwiftUI с загрузкой данных и состояниями ошибки.
  • Напиши сетевой клиент на Swift с async/await и декодированием JSON.
  • Покажи, как организовать поиск по вводу пользователя с помощью Combine.

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

1Через Skills CLI (Vercel)

npx skills add personamanagmentlayer/pcl --skill swift-expert -a claude-code

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

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

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

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

Вопросы о swift-expert

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

Выполните npx skills add personamanagmentlayer/pcl --skill swift-expert -a claude-code. Файл скилла появится по пути ~/.claude/skills/swift-expert/SKILL.md.

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

Он помогает с разработкой на Swift для iOS и macOS: от SwiftUI и Combine до async/await, акторов и сетевых запросов.

Какие инструменты скилл может использовать?

Ему доступны Read, Write и Edit, а для командной строки — swift и xcodebuild.

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

SKILL.md · Apache-2.0
---
name: swift-expert
version: 1.1.0
description: >-
  Expert-level Swift development for iOS, macOS with SwiftUI, Combine, and modern Swift
  5.9+. Use when the user mentions iOS, macOS, SwiftUI, Combine, async await, or Apple
  platforms, or when the task involves Modern Swift Features, Basics and Optionals,
  Functions and Closures, or Structs and Classes.
category: languages
tags: [swift, ios, macos, swiftui, combine, async-await, apple]
allowed-tools:
  - Read
  - Write
  - Edit
  - Bash(swift:*, xcodebuild:*)
---

# Swift Expert

Expert guidance for Swift development including iOS/macOS apps, SwiftUI, Combine, async/await, and Swift 5.9+ features.

## Core Concepts

### Modern Swift Features (5.9+)

- Async/await concurrency
- Actors for thread safety
- Property wrappers
- Result builders
- Protocols and generics
- Value types vs reference types
- Automatic Reference Counting (ARC)
- Macros (Swift 5.9+)

### SwiftUI

- Declarative UI framework
- State management
- View composition
- Layout system
- Animations
- Navigation

### Combine

- Reactive programming
- Publishers and subscribers
- Operators
- Error handling

## SwiftUI

### Basic Views

```swift
import SwiftUI

struct ContentView: View {
    @State private var name = ""
    @State private var count = 0

    var body: some View {
        VStack(spacing: 20) {
            Text("Hello, \(name.isEmpty ? "World" : name)!")
                .font(.title)
                .foregroundColor(.blue)

            TextField("Enter name", text: $name)
                .textFieldStyle(.roundedBorder)
                .padding()

            HStack {
                Button("Decrement") {
                    count -= 1
                }

                Text("\(count)")
                    .frame(minWidth: 50)

                Button("Increment") {
                    count += 1
                }
            }
            .buttonStyle(.borderedProminent)
        }
        .padding()
    }
}
```

### State Management

```swift
// @State - local view state
struct CounterView: View {
    @State private var count = 0

    var body: some View {
        Button("Count: \(count)") {
            count += 1
        }
    }
}

// @Binding - pass state reference
struct ChildView: View {
    @Binding var isOn: Bool

    var body: some View {
        Toggle("Setting", isOn: $isOn)
    }
}

// @ObservableObject - external state
class UserViewModel: ObservableObject {
    @Published var user: User?
    @Published var isLoading = false
    @Published var error: Error?

    func fetchUser() async {
        isLoading = true
        defer { isLoading = false }

        do {
            user = try await APIClient.shared.fetchUser()
        } catch {
            self.error = error
        }
    }
}

struct UserView: View {
    @StateObject private var viewModel = UserViewModel()

    var body: some View {
        Group {
            if viewModel.isLoading {
                ProgressView()
            } else if let user = viewModel.user {
                UserDetailView(user: user)
            } else if let error = viewModel.error {
                ErrorView(error: error)
            }
        }
        .task {
            await viewModel.fetchUser()
        }
    }
}

// @EnvironmentObject - app-wide state
@main
struct MyApp: App {
    @StateObject private var appState = AppState()

    var body: some Scene {
        WindowGroup {
            ContentView()
                .environmentObject(appState)
        }
    }
}

struct SomeView: View {
    @EnvironmentObject var appState: AppState

    var body: some View {
        Text(appState.currentUser?.name ?? "Guest")
    }
}
```

### Lists and Navigation

```swift
struct PostListView: View {
    let posts: [Post]
    @State private var selectedPost: Post?

    var body: some View {
        NavigationStack {
            List(posts) { post in
                NavigationLink(value: post) {
                    VStack(alignment: .leading) {
                        Text(post.title)
                            .font(.headline)
                        Text(post.excerpt)
                            .font(.subheadline)
                            .foregroundColor(.secondary)
                    }
                }
            }
            .navigationTitle("Posts")
            .navigationDestination(for: Post.self) { post in
                PostDetailView(post: post)
            }
        }
    }
}
```

### Custom Modifiers

```swift
struct CardModifier: ViewModifier {
    func body(content: Content) -> some View {
        content
            .padding()
            .background(Color.white)
            .cornerRadius(10)
            .shadow(radius: 5)
    }
}

extension View {
    func cardStyle() -> some View {
        modifier(CardModifier())
    }
}

// Usage
Text("Hello")
    .cardStyle()
```

## Networking

```swift
actor APIClient {
    static let shared = APIClient()

    private let baseURL = URL(string: "https://api.example.com")!
    private let decoder: JSONDecoder = {
        let decoder = JSONDecoder()
        decoder.keyDecodingStrategy = .convertFromSnakeCase
        return decoder
    }()

    func fetch<T: Decodable>(_ endpoint: String) async throws -> T {
        let url = baseURL.appendingPathComponent(endpoint)
        let (data, response) = try await URLSession.shared.data(from: url)

        guard let httpResponse = response as? HTTPURLResponse,
              (200...299).contains(httpResponse.statusCode) else {
            throw APIError.invalidResponse
        }

        return try decoder.decode(T.self, from: data)
    }

    func post<T: Encodable, R: Decodable>(
        _ endpoint: String,
        body: T
    ) async throws -> R {
        var request = URLRequest(url: baseURL.appendingPathComponent(endpoint))
        request.httpMethod = "POST"
        request.setValue("application/json", forHTTPHeaderField: "Content-Type")
        request.httpBody = try JSONEncoder().encode(body)

        let (data, _) = try await URLSession.shared.data(for: request)
        return try decoder.decode(R.self, from: data)
    }
}

enum APIError: LocalizedError {
    case invalidResponse
    case decodingError

    var errorDescription: String? {
        switch self {
        case .invalidResponse:
            return "Invalid server response"
        case .decodingError:
            return "Failed to decode response"
        }
    }
}
```

## Combine Framework

```swift
import Combine

class SearchViewModel: ObservableObject {
    @Published var searchText = ""
    @Published var results: [SearchResult] = []
    @Published var isLoading = false

    private var cancellables = Set<AnyCancellable>()

    init() {
        $searchText
            .debounce(for: .milliseconds(300), scheduler: DispatchQueue.main)
            .removeDuplicates()
            .sink { [weak self] text in
                self?.performSearch(text)
            }
            .store(in: &cancellables)
    }

    private func performSearch(_ text: String) {
        guard !text.isEmpty else {
            results = []
            return
        }

        isLoading = true

        Task {
            do {
                let searchResults: [SearchResult] = try await APIClient.shared
                    .fetch("search?q=\(text)")
                await MainActor.run {
                    self.results = searchResults
                    self.isLoading = false
                }
            } catch {
                await MainActor.run {
                    self.isLoading = false
                }
            }
        }
    }
}
```

## Testing

```swift
import XCTest
@testable import MyApp

final class UserViewModelTests: XCTestCase {
    var viewModel: UserViewModel!
    var mockAPIClient: MockAPIClient!

    override func setUp() {
        super.setUp()
        mockAPIClient = MockAPIClient()
        viewModel = UserViewModel(apiClient: mockAPIClient)
    }

    func testFetchUserSuccess() async throws {
        // Given
        let expectedUser = User(id: UUID(), name: "Alice", email: "[email protected]")
        mockAPIClient.userToReturn = expectedUser

        // When
        await viewModel.fetchUser()

        // Then
        XCTAssertEqual(viewModel.user?.name, "Alice")
        XCTAssertNil(viewModel.error)
        XCTAssertFalse(viewModel.isLoading)
    }

    func testFetchUserFailure() async {
        // Given
        mockAPIClient.shouldFail = true

        // When
        await viewModel.fetchUser()

        // Then
        XCTAssertNil(viewModel.user)
        XCTAssertNotNil(viewModel.error)
        XCTAssertFalse(viewModel.isLoading)
    }
}

// Mock
class MockAPIClient {
    var userToReturn: User?
    var shouldFail = false

    func fetchUser() async throws -> User {
        if shouldFail {
            throw APIError.invalidResponse
        }
        return userToReturn ?? User(id: UUID(), name: "Test", email: "[email protected]")
    }
}
```

## Best Practices

### Code Organization

- Use MVVM pattern for SwiftUI
- Separate business logic from views
- Use dependency injection
- Keep views small and composable

### Memory Management

- Understand ARC (Automatic Reference Counting)
- Use weak references for delegates
- Break retain cycles with [weak self] or [unowned self]
- Use actors for mutable shared state

### Performance

- Use lazy loading where appropriate
- Avoid unnecessary view updates
- Profile with Instruments
- Use value types (structs) by default

### Swift Concurrency

- Prefer async/await over completion handlers
- Use actors for thread-safe mutable state
- Use @MainActor for UI updates
- Avoid blocking the main thread

## Anti-Patterns to Avoid

❌ **Force unwrapping**: Use optional binding instead
❌ **Massive view controllers**: Extract logic to view models
❌ **Strong reference cycles**: Use weak/unowned references
❌ **Blocking main thread**: Use async/await
❌ **Ignoring memory warnings**: Handle memory pressure
❌ **Not using guard**: Use guard for early exits
❌ **Implicit unwrapping**: Prefer explicit optionals

## Reference Documentation

Detailed material lives alongside this skill and is read on demand:

- [Swift Syntax](references/SWIFT_SYNTAX.md) — Basics and Optionals, Functions and Closures, Structs and Classes, Enums, Async/Await (Swift 5.5+), Actors (Thread Safety)

## Resources

- Swift Documentation: https://swift.org/documentation/
- SwiftUI Tutorials: https://developer.apple.com/tutorials/swiftui
- WWDC Sessions: https://developer.apple.com/videos/
- Swift by Sundell: https://www.swiftbysundell.com/
- Hacking with Swift: https://www.hackingwithswift.com/

© personamanagmentlayer · Apache-2.0 · personamanagmentlayer/pcl

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

Все скиллы по теме «Языки программирования» →

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

swift-expert https://github.com/Jeffallan Скилл swift-expert для Claude Code: архитектура, SwiftUI, async/await, акторы и тесты на Swift. Ведёт агента при написании и разборе кода под iOS и macOS. CX Codex +1 4 500установок ios-swift-development aj-geddes Скилл ios-swift-development для разработки нативных iOS-приложений на Swift в Claude Code. Охватывает MVVM, SwiftUI, асинхронные запросы через URLSession и сохранение данных с Core Data. CX Codex +1 1 500установок swift Mindrally Настраивает агента на разработку приложений под iOS, macOS, watchOS и tvOS на Swift и SwiftUI с архитектурой MVVM. CX Codex +1 748установок clerk-swift clerk Скилл clerk-swift для Claude Code настраивает UI аутентификации Clerk в нативных приложениях Swift на iOS и macOS. Помогает внедрить готовые экраны ClerkKitUI или собрать собственный флоу через ClerkKit. CX Codex +1 15 200установок 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установок swift-optimise pproenca Скилл swift-optimise разбирает производительность Swift и SwiftUI: конкуренцию, отрисовку и анимации. Нужен при профилировании clinic-модулей. CX Codex +1 293установок

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

Весь набор →
codeql-expert Скилл codeql-expert помогает писать и запускать запросы CodeQL, искать уязвимости и подключать анализ к GitHub Code Scanning. Работает с несколькими языками. CX Codex +1 174установок skill-creator-expert Скилл skill-creator-expert помогает проектировать, писать и проверять скиллы PCL: разбирает предметную область, собирает структуру и прогоняет готовый файл по чек-листу качества. CX Codex +1 173установок django-expert Скилл django-expert помогает проектировать веб-приложения на Django: модели ORM, представления, формы, маршруты и API на Django REST Framework. CX Codex +1 172установок graphql-expert Скилл graphql-expert помогает проектировать GraphQL-схемы, писать резолверы и разбирать подписки. Пригодится при работе с Apollo Server, федерацией и проблемой N+1. CX Codex +1 169установок data-mesh-expert Скилл data-mesh-expert помогает агенту проектировать data mesh: домены владеют своими данными, дата-продукты идут с контрактами, управление федеративное, платформа самообслуживания. CX Codex +1 168установок linkerd-expert Скилл linkerd-expert по Linkerd для Kubernetes: агент ставит меш, включает инъекцию прокси, снимает метрики через linkerd viz и настраивает политики доступа. CX Codex +1 162установок pcl-expert Скилл pcl-expert для Claude Code описывает Persona Control Language: объявления persona, team и workflow, компилятор, LSP и MCP. Помогает агенту править .pcl-файлы и компилятор. CX Codex +1 160установок sql-expert Скилл sql-expert для экспертной работы с SQL: проектирование схем, написание эффективных запросов, оптимизация индексов и администрирование PostgreSQL, MySQL и SQL Server. CX Codex +1 1установок

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

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