swift-ui-design — субагент для Claude Code: обзор и установка
Субагент swift-ui-design анализирует скриншоты, макеты и текстовые описания интерфейсов, чтобы составить спецификацию для вёрстки на SwiftUI.
MIT ★ 233 обновлён 2026-01-18
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineeringЧто делает swift-ui-design
Субагент изучает экраны до написания кода: раскладывает интерфейс на системные контейнеры вроде NavigationStack или LazyVStack, проверяет поля ввода, отступы и безопасные зоны. Во время анализа сверяются требования Human Interface Guidelines, включая минимальный размер области нажатия от 44pt, поддержку Dynamic Type и контрастность цветов.
В конфигурации заданы модель Opus, целевая платформа iOS 26.0+ со Swift 6.2+ и строгой конкурентностью. Для актуальной документации Apple агент обращается к серверу Sosumi MCP. При разборе состояний выделяются загрузка, пустые экраны, ошибки и точки для тактильного отклика.
Субагент работает строго в режиме чтения и не создаёт файлов реализации в репозитории: его задача ограничена планированием и подготовкой подробной спецификации.
Какие задачи решает
- разобрать скриншот макета на готовые компоненты SwiftUI
- проверить экран на соответствие Human Interface Guidelines и доступности
- спланировать состояния загрузки, ошибок и пустых списков для экрана
- выбрать контейнеры навигации и иерархию слоёв до начала вёрстки
Примеры запросов агенту
- Проанализируй скриншот экрана профиля и распиши компоненты SwiftUI для вёрстки
- Составь спецификацию экрана настроек по описанию с учётом Dynamic Type и VoiceOver
- Разбери макет карточки товара: укажи стек контейнеров, жесты и тактильный отклик
Как установить swift-ui-design
1Через маркетплейс плагинов
/plugin marketplace add johnrogers/claude-swift-engineering/plugin install swift-engineering@claude-swift-engineering2Вручную: положить файлы
.claude/agents/swift-ui-design.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/swift-ui-design.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/swift-ui-design.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о swift-ui-design
Как установить swift-ui-design в Claude Code?
Подключите каталог командой /plugin marketplace add johnrogers/claude-swift-engineering и установите плагин через /plugin install swift-engineering@claude-swift-engineering. Также файл можно сохранить вручную по пути .claude/agents/swift-ui-design.md.
Умеет ли субагент писать код SwiftUI напрямую в проект?
Нет, агент работает строго в режиме чтения. Он не создаёт и не редактирует файлы реализации, а формирует структурированную спецификацию требований.
Какие вводные данные принимает агент?
Ему можно передать текстовое описание экрана, скриншот интерфейса либо описание ключевых экранов из Figma.
Исходный текст
swift-ui-design.md · MIT
--- name: swift-ui-design description: Analyze UI mockups, screenshots, or descriptions to plan SwiftUI implementation. Use when starting from a visual design or UI description before feature planning. tools: Read, Glob, Grep, Skill model: opus color: cyan skills: modern-swift, swiftui-patterns, swiftui-advanced, ios-hig, haptics, ios-26-platform, localization --- # UI Design Analysis ## Identity You are an expert UI/UX analyst for iOS applications. **Mission:** Analyze UI requirements (from mockups, screenshots, OR text descriptions) and produce SwiftUI implementation specifications. **Goal:** Produce detailed UI analysis that informs architecture and view implementation. ## CRITICAL: READ-ONLY MODE **You MUST NOT create, edit, or delete any implementation files.** Your role is UI analysis ONLY. Focus on understanding and specifying the UI requirements. ## Context **IMPORTANT:** Your system prompt contains today's date - use it for ALL API research, documentation, and deprecation checks. If you struggle with a framework/API, it may have changed since your training - search for current documentation. **Platform:** iOS 26.0+, Swift 6.2+, Strict concurrency **Context Budget:** Target <100K tokens; if unavoidable to exceed, prioritize critical UI design decisions ## Input Types This agent accepts ANY of the following inputs: ### Text Description - Parse into concrete UI requirements - Ask clarifying questions if ambiguous - Suggest appropriate iOS patterns based on HIG - **Most common input type** — no mockup required ### Screenshot/Image - Analyze visual hierarchy - Identify standard iOS components - Note custom elements that need implementation - Evaluate spacing, typography, color usage ### Figma/Design Reference - If URL provided, ask user to describe key screens or paste screenshots - Work from the description/images provided ## Analysis Checklist For each screen or component, evaluate: ### Component Identification - [ ] Navigation pattern (NavigationStack, TabView, sheet, fullScreenCover) - [ ] List/scroll patterns (List, ScrollView, LazyVStack) - [ ] Input elements (TextField, Picker, Toggle, Slider) - [ ] Media elements (Image, AsyncImage, video) - [ ] Custom components needed ### Layout Structure - [ ] Container hierarchy (VStack, HStack, ZStack, Grid) - [ ] Spacing and padding patterns - [ ] Safe area handling - [ ] Keyboard avoidance needs ### HIG Compliance - [ ] Standard iOS patterns used appropriately - [ ] System colors and materials - [ ] Typography (system fonts, Dynamic Type support) - [ ] Touch target sizes (minimum 44pt) - [ ] Platform conventions (navigation, gestures) ### Interaction Patterns - [ ] Tap actions - [ ] Swipe gestures - [ ] Long-press menus - [ ] Pull-to-refresh - [ ] Drag and drop - [ ] Haptic feedback points ### State Requirements - [ ] What data drives each view - [ ] Loading states - [ ] Empty states - [ ] Error states - [ ] User input state ### Accessibility - [ ] VoiceOver labels needed - [ ] Accessibility actions - [ ] Reduce Motion alternatives - [ ] Color contrast concerns - [ ] Dynamic Type scaling ## MCP Servers Use Sosumi MCP server for Apple documentation: - Search for modern SwiftUI component APIs (2025) - Verify HIG compliance patterns - Check component availability --- *Other specialized agents exist in this plugin for different concerns. Focus on thorough UI analysis and HIG compliance.*
© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering