cloudkit — скилл для Claude Code: что делает и как установить
Помогает настроить синхронизацию данных в iOS и macOS через CloudKit, SwiftData и CKSyncEngine, а также разрешать конфликты синхронизации.
npx skills add dpearson2699/swift-ios-skills --skill cloudkit -a claude-codeЧто делает cloudkit
Скилл даёт шаблоны и алгоритмы для связки CloudKit с кодом на Swift. Он разбирает структуру контейнера с базами данных publicCloudDatabase, privateCloudDatabase и операции над записями CKRecord. Описаны правила создания кастомных зон записей для приватных баз и обработка очередей без холостого опроса сервера.
Для поиска данных скилл предписывает использовать предикаты NSPredicate, но учитывает ограничения шифрования: зашифрованные поля нельзя сортировать или фильтровать в CKQuery. Отдельный блок охватывает фоновые подписки CKSubscription и движок CKSyncEngine для iOS 17+.
Ограничение размера одной записи CKRecord составляет 1 МБ без учёта файлов CKAsset. При сбоях скилл запрещает запускать полную повторную синхронизацию вслепую, требуя вместо этого разбирать конкретный код ошибки CKError.
Какие задачи решает
- настроить синхронизацию моделей SwiftData с базой CloudKit
- реализовать обработку кодов ошибок CKError и сетевых сбоев
- составить предикаты для выборки записей через CKQuery
- сконфигурировать подписки CKSubscription для фоновых push-уведомлений
- внедрить CKSyncEngine для пакетного обновления данных в iOS 17+
Примеры запросов агенту
- Напиши сохранение и обновление модели в custom zone через CKRecord
- Помоги настроить CKSyncEngine для обработки изменений и разрешения конфликтов
- Как правильно обработать ошибки CKError при сохранении пакета записей?
Как установить cloudkit
1Через Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill cloudkit -a claude-code2Вручную: положить файлы
~/.claude/skills/cloudkit/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cloudkit/
1Через Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill cloudkit -a codex2Вручную: положить файлы
.agents/skills/cloudkit/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill cloudkit -a cursor2Вручную: положить файлы
.cursor/skills/cloudkit/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dpearson2699/swift-ios-skills cloudkit2Вручную: положить файлы
.github/skills/cloudkit/SKILL.md1Через Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill cloudkit -a gemini-cli2Командой платформы
gemini skills install https://github.com/dpearson2699/swift-ios-skills --path skills/cloudkitВручную: положить файлы
.devin/skills/cloudkit/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add dpearson2699/swift-ios-skills --skill cloudkit -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о cloudkit
Как установить cloudkit в Claude Code?
Выполните в терминале команду npx skills add dpearson2699/swift-ios-skills --skill cloudkit -a claude-code.
Что делает скилл cloudkit?
Он содержит инструкции по интеграции облачного хранилища Apple в приложения для iOS и macOS. Скилл помогает писать код для CKRecord, настраивать базы данных, подписки и синхронизацию SwiftData.
Какие ограничения действуют для зашифрованных полей в CKQuery?
Зашифрованные поля невозможно фильтровать или использовать в сортировке. Ссылки CKRecord.Reference шифровать нельзя, так как они нужны серверу CloudKit для связей между записями.
