К основному содержанию
скилл CX Codex

cloudkit-code-review — скилл для Claude Code

Скилл cloudkit-code-review проверяет Swift-код на ошибки работы с CloudKit: зоны, батчи, обработку CKErrorPartialFailure и лимиты CKAsset.

Apache-2.0 127 установок ★ 89 обновлён 2026-09-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add existential-birds/beagle --skill cloudkit-code-review -a claude-code
Открыть на GitHub

Что делает cloudkit-code-review

Скилл инспектирует код с import CloudKit, CKContainer, CKRecord и CKShare. Он ищет типичные сбои синхронизации: пропущенный retryAfterSeconds при лимитах запросов, затирание данных при serverRecordChanged и прямые вызовы сохранения вместо пакетного CKModifyRecordsOperation.

Замечания выводятся в формате [FILE:LINE] ISSUE_TITLE. Агент обязан прочитать окружающий контекст функции и подтвердить факт по конфигурации — например, проверить Info.plist, идентификатор контейнера или файл entitlements.

Какие задачи решает

  • Найти пропущенную обработку CKErrorPartialFailure и задержек retryAfterSeconds
  • Выявить сохранение бинарных данных свыше 1 МБ без использования CKAsset
  • Обнаружить одиночные сохранения записей вместо батчей CKModifyRecordsOperation
  • Проверить создание CKShare в кастомных зонах базы данных

Примеры запросов агенту

  • Проверь SyncManager.swift на ошибки синхронизации с CloudKit
  • Проведи ревью реализации CKShare и работы с зонами
  • Найди места, где CloudKit-колбэки обновляют UI не в главном потоке

Как установить cloudkit-code-review

1Через Skills CLI (Vercel)

npx skills add existential-birds/beagle --skill cloudkit-code-review -a claude-code

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

~/.claude/skills/cloudkit-code-review/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/cloudkit-code-review/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о cloudkit-code-review

Как установить cloudkit-code-review в Claude Code?

Выполните команду npx skills add existential-birds/beagle --skill cloudkit-code-review -a claude-code.

Что делает скилл cloudkit-code-review?

Он находит ошибки в коде CloudKit, включая некорректную обработку сбоев сети, отсутствие батчинга и запуск шаринга в дефолтной зоне.

В каком формате скилл выдаёт замечания?

Каждая проблема выводится строкой [FILE:LINE] ISSUE_TITLE только после сверки контекста функции с файлами конфигурации.

Исходный текст

SKILL.md · Apache-2.0
---
name: cloudkit-code-review
description: Reviews CloudKit code for container setup, record handling, subscriptions, and sharing patterns. Use when reviewing code with import CloudKit, CKContainer, CKRecord, CKShare, or CKSubscription.
---

# CloudKit Code Review

## Quick Reference

| Issue Type | Reference |
|------------|-----------|
| CKContainer, databases, zones, entitlements | [references/container-setup.md](references/container-setup.md) |
| CKRecord, references, assets, batch operations | [references/records.md](references/records.md) |
| CKSubscription, push notifications, silent sync | [references/subscriptions.md](references/subscriptions.md) |
| CKShare, participants, permissions, acceptance | [references/sharing.md](references/sharing.md) |

## Review Checklist

- [ ] Account status checked before private/shared database operations
- [ ] Custom zones used (not default zone) for production data
- [ ] All CloudKit errors handled with `retryAfterSeconds` respected
- [ ] `serverRecordChanged` conflicts handled with proper merge logic
- [ ] `CKErrorPartialFailure` parsed for individual record errors
- [ ] Batch operations used (`CKModifyRecordsOperation`) not individual saves
- [ ] Large binary data stored as `CKAsset` (records have 1MB limit)
- [ ] Record keys type-safe (enums) not string literals
- [ ] UI updates dispatched to main thread from callbacks
- [ ] `CKAccountChangedNotification` observed for account switches
- [ ] Subscriptions have unique IDs to prevent duplicates
- [ ] CKShare uses custom zone (sharing requires custom zones)

## When to Load References

- Reviewing container/database setup or zones -> container-setup.md
- Reviewing record CRUD or relationships -> records.md
- Reviewing push notifications or sync triggers -> subscriptions.md
- Reviewing sharing or collaboration features -> sharing.md

## Output Format

Report issues using: `[FILE:LINE] ISSUE_TITLE`

Examples:
- `[AppDelegate.swift:24] CKContainer not in custom zone`
- `[SyncManager.swift:156] Unhandled CKErrorPartialFailure`
- `[DataStore.swift:89] Missing retryAfterSeconds backoff`

## Review Questions

1. What happens when the user is signed out of iCloud?
2. Does error handling respect rate limiting (`retryAfterSeconds`)?
3. Are conflicts resolved or does data get overwritten silently?
4. Is the schema deployed to production before App Store release?
5. Are shared records in custom zones (required for CKShare)?

## Hard gates (before reporting)

Complete **in order** for each finding you intend to report. Do not advance until the pass condition is satisfied.

1. **Location artifact** — The finding includes `[FILE:LINE]` (or a line range) copied from the current file contents; the path resolves in this repo.
2. **Scope read** — You read the full surrounding unit: the type or function that owns the CloudKit work (for example the `CKOperation` subclass usage, completion handler chain, or `CKRecord` lifecycle), not only a diff hunk or isolated snippet.
3. **CloudKit or deployment claim** (only if the finding depends on container identifiers, public vs private database choice, custom zone requirement, iCloud account state, entitlements, or production schema) — You name one concrete artifact you inspected (for example `com.apple.developer.icloud-container-environment` or container ID in the entitlements file, `CKContainer.default()` vs custom identifier in source, `Info.plist` / target capability, or evidence that schema is deployed) **or** you downgrade the item to an open question in [Review Questions](#review-questions).
4. **Protocol** — Pre-report steps in [review-verification-protocol](../review-verification-protocol/SKILL.md) are satisfied for this item (no finding if they are not).

Use the issue format `[FILE:LINE] ISSUE_TITLE` for each reported finding. Hard gate 4 is the full pre-report checklist for this skill’s review type.

© existential-birds · Apache-2.0 · existential-birds/beagle

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
cloudkit dpearson2699 Помогает настроить синхронизацию данных в iOS и macOS через CloudKit, SwiftData и CKSyncEngine, а также разрешать конфликты синхронизации. CX Codex +1 3 600установок core-data-expert AvdLee Скилл core-data-expert помогает настроить стек Core Data в iOS и macOS, наладить многопоточность и устранить сбои при миграциях или синхронизации с CloudKit. CX Codex +1 2 500установок release-review rshankras Скилл release-review прогоняет приложение для macOS и iOS по чек-листам релиза и выдаёт список проблем с готовыми правками. Пригодится перед отправкой в App Store или TestFlight. CX Codex +1 550установок guide-swiftdata Prisma-Labs-Dev Скилл guide-swiftdata для написания, ревью и отладки кода SwiftData: подсказывает безопасные предикаты, правила автосохранения и ограничения CloudKit. CX Codex +1 538установок swiftdata dpearson2699 Подсказывает агенту, как писать модели, запросы и миграции SwiftData, чтобы код на Swift 6.3 собирался без типичных промахов. CX Codex +1 4 400установок apple-app-services Fandhe-AI Скилл apple-app-services для Claude Code даёт агенту справочники по нативным фреймворкам Apple. Помогает писать код со StoreKit 2, CloudKit, WidgetKit, Core Location и Sign in with Apple. CX Codex +1 104установок

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

Весь набор →
swiftdata-code-review Скилл swiftdata-code-review проверяет код SwiftData на ошибки в моделях, предикатах, миграциях и конкурентности. Запускается при ревью файлов со связками @Model и @Query. CX Codex +1 136установок howto-docs Скилл howto-docs помогает писать пошаговые how-to-гайды под конкретную задачу: с предусловиями, шагами, проверкой результата и разбором типичных проблем. CX Codex +1 135установок deepagents-code-review Скилл deepagents-code-review проверяет код на create_deep_agent: ловит забытый checkpointer, относительные пути и бэкенды без хранилища. CX Codex +1 134установок healthkit-code-review Скилл healthkit-code-review для Claude Code разбирает код с HealthKit по шагам: авторизацию, запросы, observer-запросы и фоновую доставку. Проверяет работу приложения с данными о здоровье. CX Codex +1 134установок prometheus-go-code-review Скилл prometheus-go-code-review для Claude Code проверяет Prometheus-метрики в Go: типы, лейблы, имена и регистрацию. Ревьюирует код с prometheus/client_golang. CX Codex +1 126установок review-skill-improver Скилл review-skill-improver для Claude Code анализирует журнал отзывов о код-ревью и предлагает правки к скиллам. Выявляет повторяющиеся причины отказов по оценкам ACCEPT и REJECT. CX Codex +1 125установок elixir-code-review Скилл elixir-code-review проверяет код на Elixir по правилам OTP, безопасности и стиля. Помогает при разборе файлов .ex и .exs. CX Codex +1 124установок app-intents-code-review Скилл app-intents-code-review проводит ревью кода Swift с фреймворком App Intents, проверяя таймауты, локализацию фраз и совместимость версий iOS. CX Codex +1 124установок

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

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