swiftui-guidance-for-macos — плагин для Claude Code: установка
Справочник по архитектуре SwiftUI под macOS с разбором рантайма, акторов и AppKit. Пригодится при отладке лишних перерисовок и потере состояния окон.
/plugin marketplace add anthropics/claude-plugins-community
/plugin install swiftui-guidance-for-macos@claude-communityЧто делает swiftui-guidance-for-macos
Плагин даёт Claude Code базу знаний по внутреннему устройству SwiftUI на macOS. В материалах разбирается механика Observation (_modify, версионирование и стримы Observations {}), а также граф идентичности представлений, из-за сбоев которого сбрасывается локальное состояние интерфейса.
Внутрь вошли справочники по интеграции с AppKit через NSViewRepresentable и NSHostingView, управлению сценами вроде MenuBarExtra и работе со SwiftData через @ModelActor. Также есть инструкции по адаптации под VoiceOver и Dynamic Type.
Плагин ориентирован строго на macOS 26+ и Swift 6.2 со строгой многопоточностью (strict concurrency). Базовый синтаксис он пропускает, переходя сразу к разбору специфических ошибок планирования акторов и изоляции данных.
Какие задачи решает
- устранить лишние перерисовки представлений и сброс состояния
- настроить изоляцию акторов и передачу данных через
sending - связать компоненты AppKit через
NSViewRepresentableиNSHostingView - сконфигурировать окна macOS,
MenuBarExtraи команды меню
Примеры запросов агенту
- /swiftui-macos проверь, почему сбрасывается состояние в NSViewRepresentable при изменении размера окна
- /swiftui-macos помоги настроить фоновое сохранение через SwiftData и @ModelActor без блокировки главного потока
- /swiftui-macos найди причину лишних вычислений body в графе представлений SwiftUI
Как установить swiftui-guidance-for-macos
Через маркетплейс плагинов
/plugin marketplace add anthropics/claude-plugins-community/plugin install swiftui-guidance-for-macos@claude-communityПо шагам, с командами для каждой платформы: Плагины Claude Code: маркетплейсы, установка и как собрать свой
Вопросы о swiftui-guidance-for-macos
Как установить swiftui-guidance-for-macos в Claude Code?
Сначала подключите каталог командой /plugin marketplace add anthropics/claude-plugins-community. Затем запустите установку: /plugin install swiftui-guidance-for-macos@claude-community.
Для каких версий macOS и Swift предназначен плагин?
Плагин написан под macOS 26+ и Swift 6.2 с включённым режимом строгой многопоточности (strict concurrency).
Что входит в справочные материалы плагина?
В справочниках подробно описаны механизмы Observation, правила планирования задач в акторах, интеграция с AppKit, управление сценами macOS и настройка доступности.
Исходный текст
SKILL.md · MIT
# SwiftUI macOS Skill
An agent skill for macOS SwiftUI work, centered on observation internals, actor scheduling, view identity and AppKit integration. Its reference files explain framework behavior behind common failures, including redundant updates, lost view state and incorrect actor hops.
```text
/plugin marketplace add kageroumado/swiftui-macos-skill
/plugin install swiftui-macos
```
## Highlights
- Trace common SwiftUI failures to observation, scheduling, and view-identity behavior.
- Use the same skill for writing and reviewing macOS code.
- Consult focused references for AppKit integration, persistence, performance, and accessibility.
<details>
<summary>Full feature list</summary>
| File | Coverage |
|---|---|
| `references/observation.md` | Observation tracking: state capture, `_modify` vs `set`, version counters, scope narrowing, `Observations {}` streams, computed property propagation |
| `references/concurrency.md` | Scheduling cost hierarchy, actor isolation, SE-0461/0469/0420/0471/0472, `AsyncStream` bridging, `@concurrent`, `sending` |
| `references/views.md` | View decomposition, `.task(id:)`, preference keys, custom `Layout`, animation, navigation |
| `references/data.md` | Manager pattern, `@Bindable`, SwiftData, debounced saving, `@ModelActor`, environment injection |
| `references/platform.md` | `NSViewRepresentable`, `NSHostingView`, multi-window state, `openWindow`, AppKit bridging, macOS scenes |
| `references/scenes.md` | Scene and window API catalog: `UtilityWindow`, `MenuBarExtra` styles, `Settings`, window sizing and chrome, `Commands`, file dialogs, `Table`, `PasteButton` |
| `references/performance.md` | View identity graph, `.id()` dangers, `Equatable` views, `@State` for gestures, `Canvas`, `TimelineView`, `drawingGroup()` |
| `references/api.md` | Deprecated API replacements, Swift modernisms, `@Previewable`, `@Entry`, Apple open-source Swift packages |
| `references/accessibility.md` | VoiceOver, Dynamic Type, keyboard navigation, accessibility rotors, `@AccessibilityFocusState`, drag-and-drop a11y, testing |
</details>
## Notes
- Invoke `/swiftui-macos` in Claude Code or `$swiftui-macos` in Codex.
- Manual installation: copy `skills/swiftui-macos` into the agent’s user or project skills directory.
- Contributions should explain recurring errors or framework behavior and include supporting evidence.
© kageroumado · MIT · kageroumado/swiftui-macos-skill
