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

sqlite-data — скилл для Claude Code: что делает и как установить

Помогает проектировать базы данных на Swift с библиотекой SQLiteData, писать выборки через макросы и настраивать синхронизацию с CloudKit.

MIT ★ 233 обновлён 2026-01-18

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering
Открыть на GitHub

Что делает sqlite-data

Скилл направляет агента при работе с библиотекой SQLiteData в проектах на Swift. Он содержит справочники по разметке таблиц макросом @Table, выборкам через @FetchAll и @FetchOne, составлению транзакций в блоке database.write и подключению зависимостей через @Dependency(\.defaultDatabase).

Внутри заложены готовые правила для SwiftUI, UIKit и The Composable Architecture. Скилл подсказывает, как оформлять миграции через DatabaseMigrator или #sql(), настраивать рекурсивные CTE, полнотекстовый поиск FTS5 и тесты с сидированием базы.

Любое изменение структуры @Table без отдельной миграции гарантированно уронит приложение при запуске. Поэтому скилл блокирует типичные ошибки: следит за наличием миграций, требует внедрять SyncDelegate для CloudKit и предупреждает N+1 запросы в циклах.

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

  • описать таблицы и связи в SQLite через макрос @Table
  • настроить реактивные выборки данных для представлений SwiftUI
  • составить безопасные транзакции записи без блокировок потока
  • подготовить миграции схемы базы с помощью DatabaseMigrator
  • подключить синхронизацию личной базы данных с CloudKit

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

  • Объяви модель заметки через макрос @Table со свойствами id, title и createdAt
  • Напиши запрос выборки через @FetchAll с сортировкой по дате для списка SwiftUI
  • Создай миграцию схемы для добавления нового поля в таблицу пользователей

Как установить sqlite-data

1Через маркетплейс плагинов

/plugin marketplace add johnrogers/claude-swift-engineering
/plugin install swift-engineering@claude-swift-engineering

Команда ставит плагин swift-engineering целиком, со всеми его скиллами

2Через Skills CLI (Vercel)

npx skills add johnrogers/claude-swift-engineering --skill sqlite-data -a claude-code

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

~/.claude/skills/sqlite-data/SKILL.md

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

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

Вопросы о sqlite-data

Как установить sqlite-data в Claude Code?

Подключите каталог и установите плагин командами /plugin marketplace add johnrogers/claude-swift-engineering и /plugin install swift-engineering@claude-swift-engineering.

Что делает этот скилл?

Он даёт Claude Code контекст и правила работы с библиотекой SQLiteData, макросами таблиц, транзакциями, реактивными запросами и миграциями в Swift.

Зачем для CloudKit обязательно реализовывать SyncDelegate?

Без методов делегата синхронизации приложение не сможет перехватывать ошибки передачи данных и разрешать конфликты записей.

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

SKILL.md · MIT
---
name: sqlite-data
description: Use when working with SQLiteData library (@Table, @FetchAll, @FetchOne macros) for SQLite persistence, queries, writes, migrations, or CloudKit private database sync.
---

# SQLite Data

SQLiteData provides type-safe SQLite access through Swift macros, simplifying database modeling and queries while handling CloudKit sync, migrations, and async patterns automatically.

## Reference Loading Guide

**ALWAYS load reference files if there is even a small chance the content may be required.** It's better to have the context than to miss a pattern or make a mistake.

| Reference | Load When |
|-----------|-----------|
| **[Table Models](references/models.md)** | Defining tables with `@Table`, setting up primary keys, columns, or enums |
| **[Queries - Basics](references/queries-basics.md)** | Using `@FetchAll`, `@FetchOne`, `@Selection`, filtering, ordering, or joins |
| **[Queries - Advanced](references/queries-advanced.md)** | Using `@Fetch` with `FetchKeyRequest`, dynamic queries, recursive CTEs, or direct reads |
| **[Writes](references/writes.md)** | Inserting, updating, upserting, deleting records, or managing transactions |
| **[Views - SwiftUI](references/views-swiftui.md)** | Using `@FetchAll`/`@FetchOne` in SwiftUI views, `@Observable` models, or animations |
| **[Views - Integration](references/views-integration.md)** | UIKit integration, dynamic query loading, TCA integration, or `observe {}` |
| **[Migrations](references/migrations.md)** | Creating database migrations with `DatabaseMigrator` or `#sql()` macro |
| **[CloudKit Sync](references/cloudkit.md)** | Setting up CloudKit private database sync, sharing, or sync delegates |
| **[Dependencies](references/dependencies.md)** | Injecting database/sync engine via `@Dependency`, bootstrap patterns, or TCA integration |
| **[Testing](references/testing.md)** | Setting up test databases, seeding data, or writing assertions for SQLite code |
| **[Advanced - Queries](references/advanced-queries.md)** | Implementing triggers, custom database functions, or full-text search (FTS5) |
| **[Advanced - Optimization](references/advanced-optimization.md)** | Performance tuning, indexes, custom aggregates, JSON aggregation, or self-joins |
| **[Schema Composition](references/schema-composition.md)** | Using `@Selection` column groups, single-table inheritance, or database views |

## Core Workflow

When working with SQLiteData:
1. Define table models with `@Table` macro
2. Use `@FetchAll`/`@FetchOne` property wrappers in views or `@Observable` models
3. Access database via `@Dependency(\.defaultDatabase)`
4. Perform writes in `database.write { }` transactions
5. Set up migrations before first use

## Common Mistakes

1. **N+1 query patterns** — Loading records one-by-one in a loop (e.g., fetching user then fetching all their posts separately) kills performance. Use joins or batch fetches instead.

2. **Missing migrations on schema changes** — Modifying `@Table` without creating a migration causes crashes at runtime. Always create migrations for schema changes before deploying.

3. **Improper transaction handling** — Long-running transactions outside of `database.write { }` block can cause deadlocks or data loss. Keep write blocks short and focused.

4. **Ignoring CloudKit sync delegates** — Setting up CloudKit sync without implementing `SyncDelegate` means you miss error handling and conflict resolution. Implement all delegate methods for production.

5. **Over-fetching in SwiftUI views** — Using `@FetchAll` without filtering/limiting can load thousands of records, freezing the UI. Use predicates, limits, and sorting to keep in-memory footprint small.

© John Rogers (@johnrogers) · MIT · johnrogers/claude-swift-engineering

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

Все скиллы по теме «Мобильная разработка» →
core-data-expert AvdLee Скилл core-data-expert помогает настроить стек Core Data в iOS и macOS, наладить многопоточность и устранить сбои при миграциях или синхронизации с CloudKit. CX Codex +1 2 500установок swiftdata dpearson2699 Подсказывает агенту, как писать модели, запросы и миграции SwiftData, чтобы код на Swift 6.3 собирался без типичных промахов. CX Codex +1 4 400установок axiom-data CharlesWiltgen Скилл axiom-data для Claude Code маршрутизирует задачи хранения данных в Apple-приложениях к справочникам по SwiftData, Core Data, GRDB, SQLiteData, CloudKit и миграциям. CX Codex +1 1 400установок tipkit dpearson2699 Скилл tipkit для Claude Code помогает добавлять и проверять подсказки Apple TipKit в приложениях для iOS. Он подключается к задачам с TipView, popoverTip, правилами показа и событиями. CX Codex +1 3 900установок sqlite-to-fast-sql Cap-go Скилл sqlite-to-fast-sql для Claude Code переводит хранилище Capacitor на @capgo/capacitor-fast-sql. Заменяет вызовы базы данных, настраивает локальный транспорт и правит сетевые манифесты платформ. CX Codex +1 768установок guide-swiftdata Prisma-Labs-Dev Скилл guide-swiftdata для написания, ревью и отладки кода SwiftData: подсказывает безопасные предикаты, правила автосохранения и ограничения CloudKit. CX Codex +1 538установок

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

Весь набор →
swiftui-specialist Субагент swiftui-specialist пишет SwiftUI-экраны по Apple HIG после того, как бизнес-логика и TCA уже готовы. CX Codex ★ 233звёзд репо swift-ui-design Субагент swift-ui-design анализирует скриншоты, макеты и текстовые описания интерфейсов, чтобы составить спецификацию для вёрстки на SwiftUI. CX Codex ★ 233звёзд репо foundation-models Подключает паттерны работы с Foundation Models Apple: суммаризацию, извлечение данных и классификацию текста на устройстве. Claude Code сверяется с ним при настройке LanguageModelSession и @Generable. CX Codex +1 ★ 233звёзд репо tca-engineer Субагент tca-engineer пишет код TCA-фичи по готовому дизайну: редьюсер, состояние, экшены и клиенты зависимостей с тестовыми реализациями. Вьюхи не трогает. CX Codex ★ 233звёзд репо composable-architecture Скилл помогает строить функции на The Composable Architecture (TCA): организовывать редьюсеры, состояние, эффекты, навигацию и тесты. Пригодится при разработке или проверке TCA-функций. CX Codex +1 ★ 233звёзд репо modern-swift Скилл modern-swift для Claude, который ведёт агента при работе с конкурентностью в Swift 6.2: async/await, акторы, Sendable и отмена задач. CX Codex +1 ★ 233звёзд репо swiftui-patterns Скилл swiftui-patterns внедряет архитектурные паттерны SwiftUI для iOS 17+: макрос @Observable, программную навигацию и связывание с UIKit. CX Codex +1 ★ 233звёзд репо swift-testing Скилл помогает писать тесты на Swift Testing, переносить проверки с XCTest и добавлять асинхронные и параметризованные сценарии. CX Codex +1 ★ 233звёзд репо

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

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