К основному содержанию
субагент CX Codex

swift-ui-design — субагент для Claude Code: обзор и установка

Субагент swift-ui-design анализирует скриншоты, макеты и текстовые описания интерфейсов, чтобы составить спецификацию для вёрстки на SwiftUI.

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

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

Что делает 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-engineering

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

.claude/agents/swift-ui-design.md

Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

По шагам, с командами для каждой платформы: Субагенты 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

Похожие субагенты

Все субагенты по теме «Мобильная разработка» →
ios-ux-design mosif16 Скилл ios-ux-design, который подключает к ИИ-агенту экспертизу по Human Interface Guidelines и SwiftUI: аудит экранов, разбор паттернов, спецификации на доработку. CX Codex +1 549установок axiom-design CharlesWiltgen Скилл axiom-design помогает принимать решения по дизайну приложений Apple: сетки HIG, эффекты Liquid Glass, подбор SF Symbols, шрифты и переключение экранов авторизации. CX Codex +1 1 500установок clerk-swift clerk Скилл clerk-swift для Claude Code настраивает UI аутентификации Clerk в нативных приложениях Swift на iOS и macOS. Помогает внедрить готовые экраны ClerkKitUI или собрать собственный флоу через ClerkKit. CX Codex +1 15 200установок swift-ui-architect pproenca Скилл swift-ui-architect контролирует модульную архитектуру MVVM-C на SwiftUI, Swift 6.2 и локальных SPM-пакетах. Защищает границы слоёв Domain, Data и Feature при генерации и рефакторинге кода. CX Codex +1 283установок swift-expert personamanagmentlayer Скилл swift-expert для Claude Code помогает писать и разбирать код на Swift для iOS и macOS. Охватывает задачи со SwiftUI, Combine и современным синтаксисом Swift. CX Codex +1 163установок design-from-app daveebbelaar Скилл design-from-app для Claude Code воссоздает дизайн любого приложения в виде нативной дизайн-системы SwiftUI по скриншотам. CX Codex +1 1 000установок

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

Весь набор →
storekit Скилл ведёт агента через реализацию покупок в приложении: конфиг .storekit, StoreManager, проверка транзакций и экраны на SwiftUI. CX Codex +1 ★ 233звёзд репо swift-code-reviewer Субагент swift-code-reviewer проверяет код на Swift и iOS на безопасность, строгую конкурентность, производительность и соответствие HIG перед тестированием. CX Codex ★ 233звёзд репо ios-26-platform Скилл ios-26-platform помогает внедрять возможности iOS 26 в SwiftUI и сохранять поддержку iOS 17/18. Пригодится при обновлении интерфейса или настройке совместимости. CX Codex +1 ★ 233звёзд репо swiftui-specialist Субагент swiftui-specialist пишет SwiftUI-экраны по Apple HIG после того, как бизнес-логика и TCA уже готовы. CX Codex ★ 233звёзд репо foundation-models Подключает паттерны работы с Foundation Models Apple: суммаризацию, извлечение данных и классификацию текста на устройстве. Claude Code сверяется с ним при настройке LanguageModelSession и @Generable. CX Codex +1 ★ 233звёзд репо 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звёзд репо

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

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