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

swiftui-patterns · johnrogers — скилл для Claude Code: что делает и как установить

Скилл swiftui-patterns внедряет архитектурные паттерны SwiftUI для iOS 17+: макрос @Observable, программную навигацию и связывание с UIKit.

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

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

Что делает swiftui-patterns

Скилл направляет агента при разработке под iOS 17 и новее без устаревшего реактивного бойлерплейта. Он переводит модели на макрос @Observable, распределяет состояние между @State, @Bindable и @Environment, а также настраивает асинхронные операции через модификаторы .task и .refreshable.

Внутри заложена маршрутизация по двенадцати справочным файлам. Ассистент подгружает нужный контекст при работе с NavigationStack, настройке доступности для VoiceOver или оборачивании WKWebView и PHPicker в структуры UIViewRepresentable.

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

  • перевести кодовую базу с ObservableObject на макрос @Observable
  • построить программную навигацию на базе NavigationStack
  • встроить компоненты UIKit без утечек памяти в делегатах
  • добавить поддержку VoiceOver и Dynamic Type в интерфейс

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

  • Переведи экран настроек со старого протокола ObservableObject на макрос @Observable.
  • Настрой стек экранов через NavigationStack с поддержкой глубоких ссылок.
  • Оберни контроллер WKWebView через UIViewRepresentable с очисткой делегата.

Как установить swiftui-patterns

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 swiftui-patterns -a claude-code

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

~/.claude/skills/swiftui-patterns/SKILL.md

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

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

Вопросы о swiftui-patterns

Как установить swiftui-patterns в Claude Code?

Выполните сначала /plugin marketplace add johnrogers/claude-swift-engineering, а затем /plugin install swift-engineering@claude-swift-engineering.

Для чего нужен этот скилл?

Он помогает писать интерфейсы под iOS 17+ по актуальным стандартам Apple, заменяя устаревшие обёртки @StateObject и Combine на нативный @Observable.

Как скилл предотвращает утечки памяти в UIKit?

Он напоминает использовать слабые ссылки на делегаты и явно зачищать ресурсы внутри обёрток UIViewRepresentable и UIViewControllerRepresentable.

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

SKILL.md · MIT
---
name: swiftui-patterns
description: >-
  Use when implementing iOS 17+ SwiftUI patterns: @Observable/@Bindable, MVVM architecture, NavigationStack, lazy loading, UIKit interop, accessibility (VoiceOver/Dynamic Type), async operations (.task/.refreshable), or migrating from ObservableObject/@StateObject.
---

# SwiftUI Patterns (iOS 17+)

SwiftUI 17+ removes ObservableObject boilerplate with @Observable, simplifies environment injection with @Environment, and introduces task-based async patterns. The core principle: use Apple's modern APIs instead of reactive libraries.

## Overview

## Quick Reference

| Need | Use (iOS 17+) | NOT |
|------|---------------|-----|
| Observable model | `@Observable` | `ObservableObject` |
| Published property | Regular property | `@Published` |
| Own state | `@State` | `@StateObject` |
| Passed model (binding) | `@Bindable` | `@ObservedObject` |
| Environment injection | `environment(_:)` | `environmentObject(_:)` |
| Environment access | `@Environment(Type.self)` | `@EnvironmentObject` |
| Async on appear | `.task { }` | `.onAppear { Task {} }` |
| Value change | `onChange(of:initial:_:)` | `onChange(of:perform:)` |

## Core Workflow

1. Use `@Observable` for model classes (no @Published needed)
2. Use `@State` for view-owned models, `@Bindable` for passed models
3. Use `.task { }` for async work (auto-cancels on disappear)
4. Use `NavigationStack` with `NavigationPath` for programmatic navigation
5. Apply `.accessibilityLabel()` and `.accessibilityHint()` to interactive elements

## 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 |
|-----------|-----------|
| **[Observable](references/observable.md)** | Creating new `@Observable` model classes |
| **[State Management](references/state-management.md)** | Deciding between `@State`, `@Bindable`, `@Environment` |
| **[Environment](references/environment.md)** | Injecting dependencies into view hierarchy |
| **[View Modifiers](references/view-modifiers.md)** | Using `onChange`, `task`, or iOS 17+ modifiers |
| **[Migration Guide](references/migration-guide.md)** | Updating iOS 16 code to iOS 17+ |
| **[MVVM Observable](references/mvvm-observable.md)** | Setting up view model architecture |
| **[Navigation](references/navigation.md)** | Programmatic or deep-link navigation |
| **[Performance](references/performance.md)** | Lists with 100+ items or excessive re-renders |
| **[UIKit Interop](references/uikit-interop.md)** | Wrapping UIKit components (WKWebView, PHPicker) |
| **[Accessibility](references/accessibility.md)** | VoiceOver, Dynamic Type, accessibility actions |
| **[Async Patterns](references/async-patterns.md)** | Loading states, refresh, background tasks |
| **[Composition](references/composition.md)** | Reusable view modifiers or complex conditional UI |

## Common Mistakes

1. **Over-using `@Bindable` for passed models** — Creating `@Bindable` for every property causes unnecessary view reloads. Use `@Bindable` only for mutable model properties that need two-way binding. Read-only computed properties should use regular properties.

2. **State placement errors** — Putting model state in the view instead of a dedicated `@Observable` model causes view logic to become tangled. Always separate model and view concerns.

3. **NavigationPath state corruption** — Mutating `NavigationPath` incorrectly can leave it in inconsistent state. Use `navigationDestination(for:destination:)` with proper state management to avoid path corruption.

4. **Missing `.task` cancellation** — `.task` handles cancellation on disappear automatically, but nested Tasks don't. Complex async flows need explicit cancellation tracking to avoid zombie tasks.

5. **Ignoring environment invalidation** — Changing environment values at parent doesn't invalidate child views automatically. Use `@Environment` consistently and understand when re-renders happen based on observation.

6. **UIKit interop memory leaks** — `UIViewRepresentable` and `UIViewControllerRepresentable` can leak if delegate cycles aren't broken. Weak references and explicit cleanup are required.

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

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

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

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

swiftui-patterns affaan-m Скилл swiftui-patterns задаёт правила современной разработки на SwiftUI: переход на @Observable, типобезопасная навигация и оптимизация рендеринга. Пригодится при верстке экранов под iOS и macOS. CX Codex +1 6 300установок swiftui-patterns dpearson2699 Скилл swiftui-patterns помогает строить и проверять SwiftUI-представления: состояние, композицию, окружение и изолированные превью. Нужен при рефакторинге экранов и работе с @Observable. CX Codex +1 4 900установок swiftui-patterns официальный OpenAI Скилл swiftui-patterns помогает проектировать десктопные интерфейсы на SwiftUI для macOS с правильной структурой окон, меню, тулбаров и файлов. CX Codex GP ChatGPT +1 57установок swiftui-patterns podo Скилл swiftui-patterns для Claude Code описывает архитектурные практики SwiftUI: настройку TabView, навигацию, модификаторы представлений и управление состоянием через @State и @Binding. CX Codex +1 205установок swiftui-uikit-interop dpearson2699 Скилл swiftui-uikit-interop помогает связать интерфейсы UIKit и SwiftUI без путаницы с жизненным циклом и потерей данных в общих состояниях. CX Codex +1 4 400установок swiftui-animation dpearson2699 Скилл swiftui-animation помогает настраивать анимации в SwiftUI. Он подсказывает подходящие API для пружин, фазовых переходов и соблюдения правил доступности. CX Codex +1 5 900установок iphone-duo-dual-pane-patterns mirzaaghazadeh Скилл iphone-duo-dual-pane-patterns для Claude Code, Codex, Cursor и других агентов: точные размеры дисплеев iPhone Duo в пикселях и поинтах, формы хинж-коллбэков и паттерны раскладки для каждой позы. CX Codex +1 772установок axiom-swiftui CharlesWiltgen Скилл axiom-swiftui для Claude Code, Codex, Cursor, Copilot и других агентов, который подключается при любой работе со SwiftUI: вьюхи, навигация, лейаут, анимации, жесты, отладка. Охватывает фичи iOS 26 и iPhone Duo. CX Codex +1 1 700установок iphone-duo-readiness mirzaaghazadeh Скилл iphone-duo-readiness для аудита и адаптации iOS-приложений под складной iPhone Duo. Помогает найти жёстко заданные размеры экрана, устаревшие вызовы UIScreen и ошибки вёрстки при переходе на iOS 27.1 SDK. CX Codex +1 1 100установок swiftui-motion AThevon Скилл swiftui-motion для Claude Code настраивает анимации в SwiftUI. Задаёт правила для пружин, переходов, фазовых анимаций и зум-навигации в проектах под iOS и macOS. CX Codex +1 957установок

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

Весь набор →
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звёзд репо modern-swift Скилл modern-swift для Claude, который ведёт агента при работе с конкурентностью в Swift 6.2: async/await, акторы, Sendable и отмена задач. 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звёзд репо swift-search Субагент swift-search ищет определения и реализации в Swift-проекте, затем проверяет найденные места. Вызывайте его, когда ещё не знаете, в каком файле искать. CX Codex ★ 233звёзд репо

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

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