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

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

Скилл swiftdata-code-review проверяет код SwiftData на ошибки в моделях, предикатах, миграциях и конкурентности. Запускается при ревью файлов со связками @Model и @Query.

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

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

Что делает 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-code

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

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

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

По шагам, с командами для каждой платформы: Как установить скилл в 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

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

Все скиллы по теме «Мобильная разработка» →
swiftdata-pro Paul Hudson Скилл swiftdata-pro для Claude Code анализирует, проверяет и улучшает код SwiftData с современными API и лучшими практиками. Разбирает код Swift-проектов. CX Codex +1 10 000установок guide-swiftdata Prisma-Labs-Dev Скилл guide-swiftdata для написания, ревью и отладки кода SwiftData: подсказывает безопасные предикаты, правила автосохранения и ограничения CloudKit. CX Codex +1 538установок swiftdata dpearson2699 Подсказывает агенту, как писать модели, запросы и миграции SwiftData, чтобы код на Swift 6.3 собирался без типичных промахов. CX Codex +1 4 400установок ios-chaos-monkey pproenca Скилл ios-chaos-monkey для Claude Code содержит правила и TDD-сценарии для выявления крашей и гонок данных в iOS на Swift 6.2. CX Codex +1 274установок swiftui-claude-skills podo Набор из 8 скиллов по SwiftUI для iOS 26, включая Liquid Glass, аудит интерфейса, SwiftData и Foundation Models. Пригодится при сборке и ревью кода под Xcode 26.3. CX Codex +1 207установок release-review rshankras Скилл release-review прогоняет приложение для macOS и iOS по чек-листам релиза и выдаёт список проблем с готовыми правками. Пригодится перед отправкой в App Store или TestFlight. CX Codex +1 550установок

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

Весь набор →
deepagents-implementation Скилл deepagents-implementation для Claude Code даёт рецепты сборки агентов на Deep Agents: фабрика create_deep_agent, файловые бэкенды, субагенты и стриминг LangGraph. CX Codex +1 142установок llm-judge Скилл llm-judge сравнивает две и более реализации одной задачи по файлу спецификации: собирает факты, ставит оценки по пяти измерениям и выдаёт отчёт с победителем. CX Codex +1 141установок pydantic-ai-dependency-injection Скилл pydantic-ai-dependency-injection показывает, как передавать базы данных, API-клиенты и контекст пользователя в PydanticAI через RunContext и deps_type. CX Codex +1 141установок watchos-code-review Скилл watchos-code-review для Claude Code проверяет watchOS-код на ошибки жизненного цикла, осложнений, WatchConnectivity и ограничения производительности. CX Codex +1 137установок 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установок cloudkit-code-review Скилл cloudkit-code-review проверяет Swift-код на ошибки работы с CloudKit: зоны, батчи, обработку CKErrorPartialFailure и лимиты CKAsset. CX Codex +1 127установок

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

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