swiftdata-code-review — скилл для Claude Code
Скилл swiftdata-code-review проверяет код SwiftData на ошибки в моделях, предикатах, миграциях и конкурентности. Запускается при ревью файлов со связками @Model и @Query.
Apache-2.0 136 установок ★ 89 обновлён 2026-09-15
npx skills add existential-birds/beagle --skill swiftdata-code-review -a claude-codeЧто делает swiftdata-code-review
Скилл проводит ревью Swift-кода с импортом SwiftData. Он ориентируется на четыре темы: разметка моделей (@Model, @Relationship, правила удаления), предикаты и выборки (@Query, #Predicate), фоновые операции через @ModelActor, а также версионирование схем через VersionedSchema и MigrationPlan.
Внутрь зашиты четыре обязательных шлюза проверки. Ассистент сначала сверяет область видимости, затем открывает профильные справочники из references/*.md, привязывает каждое замечание к точной строке в формате [FILE:LINE] ISSUE_TITLE и только потом формирует отчёт. Замечания без ссылок на строки отбрасываются сразу.
Чеклист отлавливает типичные сбои рантайма: отсутствие ключевого слова final у моделей, дублирование аннотации @Relationship на обеих сторонах связи и прямую передачу объектов моделей между акторами вместо DTO.
Какие задачи решает
- найти блокировки главного потока тяжёлыми выборками
@Query - проверить явные правила удаления в связях моделей
- выявить небезопасную передачу объектов SwiftData между потоками
- проконтролировать схемы
VersionedSchemaперед выпуском обновления
Примеры запросов агенту
- Проверь
ItemModel.swiftна типичные ошибки в моделях SwiftData - Сделай ревью фоновой синхронизации в файле с
@ModelActor - Посмотри предикаты и выборки в
ListView.swiftпо чеклисту SwiftData
Как установить swiftdata-code-review
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill swiftdata-code-review -a claude-code2Вручную: положить файлы
~/.claude/skills/swiftdata-code-review/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/swiftdata-code-review/
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill swiftdata-code-review -a codex2Вручную: положить файлы
.agents/skills/swiftdata-code-review/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill swiftdata-code-review -a cursor2Вручную: положить файлы
.cursor/skills/swiftdata-code-review/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install existential-birds/beagle plugins/beagle-ios/skills/swiftdata-code-review2Вручную: положить файлы
.github/skills/swiftdata-code-review/SKILL.md1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill swiftdata-code-review -a gemini-cli2Командой платформы
gemini skills install https://github.com/existential-birds/beagle --path plugins/beagle-ios/skills/swiftdata-code-reviewВручную: положить файлы
.devin/skills/swiftdata-code-review/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill swiftdata-code-review -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о swiftdata-code-review
Как установить swiftdata-code-review в Claude Code?
Выполните в терминале команду npx skills add existential-birds/beagle --skill swiftdata-code-review -a claude-code. Файл навыка запишется в ~/.claude/skills/swiftdata-code-review/SKILL.md.
Что проверяет swiftdata-code-review?
Скилл анализирует Swift-файлы с импортом SwiftData. Он ищет проблемы со связями, правилами каскадного удаления, захватом переменных в #Predicate и потокобезопасностью акторов.
В каком виде ассистент выдаёт замечания?
Каждая найденная проблема предваряется заголовком [FILE:LINE] ISSUE_TITLE с указанием конкретной строки в файле, после чего следует описание риска.
Исходный текст
SKILL.md · Apache-2.0
--- name: swiftdata-code-review description: Reviews SwiftData code for model design, queries, concurrency, and migrations. Use when reviewing .swift files with import SwiftData, @Model, @Query, @ModelActor, or VersionedSchema. --- # SwiftData Code Review ## Quick Reference | Issue Type | Reference | |------------|-----------| | @Model, @Attribute, @Relationship, delete rules | [references/model-design.md](references/model-design.md) | | @Query, #Predicate, FetchDescriptor, #Index | [references/queries.md](references/queries.md) | | @ModelActor, ModelContext, background operations | [references/concurrency.md](references/concurrency.md) | | VersionedSchema, MigrationStage, lightweight/custom | [references/migrations.md](references/migrations.md) | ## Hard gates (before reporting findings) Run in order; do not assert an issue until the gate for that issue passes. 1. **Scope — pass when:** You have the target `.swift` path(s) and confirmed SwiftData surface in scope (e.g. `import SwiftData`, `@Model`, `@Query`, `@ModelActor`, `VersionedSchema`, or migration types). If none apply, stop or narrow scope with one sentence. 2. **Reference — pass when:** For each checklist area you evaluate (models, queries, concurrency, migrations), you opened the matching `references/*.md` from the Quick Reference table **or** wrote `N/A: no <area> in this review` with a one-line reason. 3. **Evidence — pass when:** Every finding uses the `[FILE:LINE] ISSUE_TITLE` header (line range allowed) from the file you read; no finding without a cite. 4. **Report — pass when:** Findings list cites first (or inline) using `[FILE:LINE] ISSUE_TITLE`, then severity or checklist grouping—no uncited assertions. ## Review Checklist - [ ] Models marked `final` (subclassing crashes) - [ ] @Relationship decorator on ONE side only (not both) - [ ] Delete rules explicitly set (not relying on default .nullify) - [ ] Relationships initialized to empty arrays, not default objects - [ ] Batch operations used for bulk inserts (`append(contentsOf:)`) - [ ] @Query not loading thousands of items on main thread - [ ] External values in predicates captured in local variables - [ ] Scalar comparisons in predicates (not object references) - [ ] @ModelActor used for background operations - [ ] PersistentIdentifier/DTOs used to pass data between actors - [ ] VersionedSchema defined for each shipped version - [ ] MigrationPlan passed to ModelContainer ## When to Load References - Reviewing @Model or relationships -> model-design.md - Reviewing @Query or #Predicate -> queries.md - Reviewing @ModelActor or background work -> concurrency.md - Reviewing schema changes or migrations -> migrations.md ## Review Questions 1. Could this relationship assignment cause NULL foreign keys? 2. Is @Relationship on both sides creating circular references? 3. Could this @Query block the main thread with large datasets? 4. Are model objects being passed between actors unsafely? 5. Would schema changes require a migration plan?
© existential-birds · Apache-2.0 · existential-birds/beagle