swiftui-patterns · johnrogers — скилл для Claude Code: что делает и как установить
Скилл swiftui-patterns внедряет архитектурные паттерны SwiftUI для iOS 17+: макрос @Observable, программную навигацию и связывание с UIKit.
MIT ★ 233 обновлён 2026-01-18
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineeringЧто делает 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-code3Вручную: положить файлы
~/.claude/skills/swiftui-patterns/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/swiftui-patterns/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill swiftui-patterns -a codex2Вручную: положить файлы
.agents/skills/swiftui-patterns/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill swiftui-patterns -a cursor2Вручную: положить файлы
.cursor/skills/swiftui-patterns/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install johnrogers/claude-swift-engineering plugins/swift-engineering/skills/swiftui-patterns2Вручную: положить файлы
.github/skills/swiftui-patterns/SKILL.md1Через Skills CLI (Vercel)
npx skills add johnrogers/claude-swift-engineering --skill swiftui-patterns -a gemini-cli2Командой платформы
gemini skills install https://github.com/johnrogers/claude-swift-engineering --path plugins/swift-engineering/skills/swiftui-patternsВручную: положить файлы
.devin/skills/swiftui-patterns/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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 от других авторов.