cloudkit-code-review — скилл для Claude Code
Скилл cloudkit-code-review проверяет Swift-код на ошибки работы с CloudKit: зоны, батчи, обработку CKErrorPartialFailure и лимиты CKAsset.
Apache-2.0 127 установок ★ 89 обновлён 2026-09-15
npx skills add existential-birds/beagle --skill cloudkit-code-review -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/cloudkit-code-review/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/cloudkit-code-review/
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill cloudkit-code-review -a codex2Вручную: положить файлы
.agents/skills/cloudkit-code-review/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill cloudkit-code-review -a cursor2Вручную: положить файлы
.cursor/skills/cloudkit-code-review/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install existential-birds/beagle plugins/beagle-ios/skills/cloudkit-code-review2Вручную: положить файлы
.github/skills/cloudkit-code-review/SKILL.md1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill cloudkit-code-review -a gemini-cli2Командой платформы
gemini skills install https://github.com/existential-birds/beagle --path plugins/beagle-ios/skills/cloudkit-code-reviewВручную: положить файлы
.devin/skills/cloudkit-code-review/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill cloudkit-code-review -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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