Руководство по SwiftUI Agent Skills

Если выбирать только одну библиотеку: выберите ameyalambat128/swiftui-skills, если вам важны рекомендации Apple и меньше выдуманных API; выберите dpearson2699/swift-ios-skills, если нужен широкий охват разработки для iOS и точное подключение навыков по фреймворкам. Лучшее сочетание: используйте первую библиотеку как слой достоверных сведений, а из второй установите только 5–10 специализированных навыков, нужных проекту.

Самая частая проблема кода SwiftUI, созданного ИИ, заключается не в неверном синтаксисе, а в том, что код лишь выглядит правильным: неясно, кто владеет состоянием, используются устаревшие модели навигации, размыты границы конкурентного выполнения или упоминается несуществующий API. Agent Skills превращают универсальную модель в помощника, который учитывает явные инженерные ограничения платформ Apple.

Что именно представляет собой Agent Skill?

Skill обычно представляет собой каталог с файлом SKILL.md. Он сообщает таким агентам программирования, как Codex, Claude Code и Cursor, когда подключать способность, какие справочные материалы читать в первую очередь, каким правилам следовать и как оформлять результат. Это не расширение Xcode и не пакет Swift. Скорее, это инженерное руководство команды и специализированный набор знаний для ИИ.

В отличие от одного огромного промпта со всеми правилами, Skills могут загружаться только тогда, когда нужны. Рекомендации по анимации подключаются при работе с анимацией SwiftUI, правила покупок и проверки StoreKit появляются в задачах, связанных с платежами, а рекомендации по производительности загружаются при отладке прокрутки. Такой контекст для конкретной задачи обычно точнее и требует меньше токенов.

Два подхода в одной таблице

Подход первый: превратить документацию Xcode в источник достоверных сведений для ИИ

Самое ценное архитектурное решение здесь состоит в явном правиле: каждое утверждение о фактах и каждый API должны опираться на локальный каталог /docs. Агент выбирает документацию до написания кода и при проверке указывает использованные файлы. Если тип или API отсутствует, он должен сообщить о неуверенности, а не придумывать правдоподобное название.

Извлечённые материалы не ограничиваются компоновкой SwiftUI. Они охватывают App Intents, AlarmKit, StoreKit, WebKit, наследование SwiftData, Swift Concurrency, Liquid Glass, виджеты visionOS и низкоуровневые средства оптимизации, такие как InlineArray и Span.

Ограничения, о которых стоит помнить

• Требуются macOS и Xcode 26 или более поздней версии. Skill не должен давать рекомендации по SwiftUI, пока каталог документации не заполнен.
• Это широкая точка входа. Для сложных проектов всё равно нужен точный запрос, например: «Проверь владение состоянием и навигацию по документации Apple».
• Версия справочных материалов зависит от локальной версии Xcode, поэтому командам стоит согласовать набор инструментов, чтобы избежать противоречивых выводов о доступности.

Подход второй: 84 совместимых навыка для iOS

Сильная сторона этого репозитория в точном выборе навыков. Не нужно добавлять в каждый контекст весь массив знаний о разработке для Apple: приложение с подпиской, которое использует SwiftData, StoreKit 2, App Intents и WidgetKit, может установить соответствующие Skills вместе с шаблонами SwiftUI, Swift Concurrency, тестированием и доступностью.

Ниже приведён полный каталог из 84 Skills на момент обновления статьи. Раскройте каждую группу, чтобы сверить охват со стеком проекта.

Как выбрать: отталкивайтесь от задачи, а не от количества

Сценарий A: начало работы с ИИ для SwiftUI

Сначала установите swiftui-skills, чтобы учитывать требования документации Apple, а затем добавьте swiftui-patterns, swiftui-navigation, swift-concurrency, swift-testing и ios-accessibility из коллекции 84 Skills. Эти пять навыков охватывают самые частые источники ошибок в новых проектах.

Сценарий B: разработка функции в существующем продукте

Выбирайте по текущей технологии, а не по тому, что когда-нибудь может пригодиться. Добавьте storekit для подписок, app-intents и widgetkit для системных поверхностей, swiftdata или core-data для приложений, активно работающих с данными, и apple-on-device-ai для продуктов с локальным ИИ.

Сценарий C: проверка кода и повышение надёжности

Отдайте приоритет swiftui-performance, debugging-instruments, metrickit, swift-security, ios-accessibility и app-store-review. Этот набор работает скорее как контроль качества перед выпуском, чем как генератор кода.

Установка для универсальных агентов и Codex

Установка Skill с локальной документацией Apple

# Установить напрямую и извлечь документацию из Xcode
curl -fsSL https://swiftui-skills.ameyalambat.com/install | bash

# Или использовать CLI skills
npx skills add ameyalambat128/swiftui-skills

Прежде чем передавать удалённый скрипт командной оболочке, проверьте установщик в репозитории. После установки запустите setup.sh из каталога установленного Skill и перезапустите сеанс агента, чтобы он обнаружил новый Skill.

Интерактивный выбор из коллекции 84 Skills

# Открыть интерактивный выбор и указать Skills и целевых агентов
npx skills add dpearson2699/swift-ios-skills

# Установить только выбранные возможности
npx skills add dpearson2699/swift-ios-skills \
  --skill swiftui-patterns \
  --skill swift-concurrency \
  --skill swift-testing

# Проверить и обновить
npx skills check
npx skills update

Установка одного Skill в Codex

$skill-installer install \
  https://github.com/dpearson2699/swift-ios-skills/tree/main/skills/swiftui-patterns

Замените последний каталог на имя любого Skill из каталога. Правила конкретного проекта следует хранить в области проекта, а повторно используемые рекомендации по SwiftUI и разработке, в общей личной области.

Более надёжный совместный рабочий процесс

1. Укажите цель и целевую версию системы. Сообщите агенту, относится ли задача к новой функции, рефакторингу или проверке, и укажите минимальную версию iOS, чтобы новые API не использовались без проверки условий.
2. Сначала позвольте слою достоверных сведений выбрать документацию. Попросите swiftui-skills перечислить документы Apple и ограничения доступности, использованные для задачи.
3. Загружайте только Skills для конкретной задачи. Используйте swiftui-navigation для навигации и storekit для покупок вместо добавления всего каталога в одну задачу.
4. Требуйте полной проверки. Попросите агента собрать цель, запустить тесты и проверить Dynamic Type, VoiceOver и тёмный режим при изменениях интерфейса.
5. Фиксируйте решения в правилах проекта. Повторяющиеся архитектурные решения следует хранить в Skill проекта или AGENTS.md, а не обсуждать заново в каждой задаче.

Многоразовый промпт для задачи можно начать так:

Use local Apple documentation as the API source of truth,
and use swiftui-patterns, swift-concurrency, and swift-testing.
Goal: implement a testable asynchronous loading screen for an iOS 26 app.
List the selected documentation and state ownership first, then modify the code, build, and run tests.
Do not introduce an architecture that the project does not already use.

Версии и лицензии: две последние проверки

API платформ Apple быстро меняются. Эта статья проверена по коммиту swiftui-skills от 6 июля 2026 года и коммиту swift-ios-skills от 4 июля 2026 года. Содержимое репозиториев, поддерживаемые версии и количество Skills могут измениться. Всегда проверяйте бета-версии фреймворков по текущему SDK Xcode.

Лицензии тоже различаются: swiftui-skills использует MIT, а swift-ios-skills использует PolyForm Perimeter 1.0.0. Она разрешает разработку приложений и закрытые коммерческие рабочие процессы, но ограничивает переупаковку содержимого в конкурирующий продукт. Перед распространением в команде, изменением или коммерческой интеграцией прочитайте исходный файл LICENSE.

Часто задаваемые вопросы

Заменяют ли SwiftUI Agent Skills официальную документацию Apple?

Нет. Skill помогает агенту загрузить и применить правила в нужный момент. Окончательную доступность API, поведение платформы и требования проверки по-прежнему следует сверять с текущим SDK Xcode и официальными материалами Apple.

Можно ли установить обе библиотеки Skills?

Да. Они дополняют друг друга: одна предоставляет локальную документацию Apple как источник достоверных сведений, а другая, специализированные рабочие процессы для фреймворков и разработки. Выбирайте Skills для каждого проекта вместо установки всех навыков по умолчанию.

Лучше ли установить все 84 Skills?

Не обязательно. Это может быть полезно командам, которые поддерживают много проектов для платформ Apple, но для одного продукта обычно понятнее использовать от пяти до десяти часто нужных Skills. Так также проще отследить источник рекомендаций.

Эти Skills предназначены только для Codex?

Нет. Оба репозитория поддерживают несколько агентов, включая Codex, Claude Code и Cursor. Пути установки и механизмы обнаружения зависят от текущей версии каждого агента.