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

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

Помогает проектировать прямые запросы к SQLite, миграции и реактивные подписки через GRDB.swift в приложениях для iOS и macOS.

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

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

Что делает grdb

Скилл подключает набор правил и справочников для работы с библиотекой GRDB.swift. Ассистент ориентируется на сценарии, где возможностей высокоуровневых обёрток вроде SQLiteData не хватает: объединение четырёх и более таблиц через JOIN, оконные функции уровня ROW_NUMBER или RANK, а также точечные сырые SQL-запросы для критичных участков.

Внутри заложены пять справочников: начальная настройка пулов соединений DatabaseQueue и DatabasePool, протоколы записей FetchableRecord и PersistableRecord, миграции схемы через DatabaseMigrator, реактивные подписки ValueObservation и профилирование плана выполнения запросов через EXPLAIN QUERY PLAN.

Без анализа EXPLAIN QUERY PLAN оптимизировать запросы бессмысленно — скилл прямо требует проверять план перед добавлением индексов. Для работы в проекте нужны Swift 5.7+, GRDB.swift от версии 6.0, а целевая система должна быть не старее iOS 13 или macOS 10.15.

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

  • составить сложные выборки с объединением четырёх и более таблиц через SQL
  • внедрить оконные функции вроде ROW_NUMBER и RANK в запросы к локальной базе
  • настроить реактивное обновление интерфейса SwiftUI через ValueObservation
  • описать последовательные миграции базы данных с помощью DatabaseMigrator
  • найти узкие места в запросах и проверить индексы через команду EXPLAIN QUERY PLAN

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

  • Настрой DatabasePool и напиши миграцию для таблицы транзакций с индексами по дате
  • Составь сложный SQL-запрос с объединением пяти таблиц и оконной функцией ROW_NUMBER
  • Создай подписку ValueObservation на список задач для обновления представления в SwiftUI

Как установить grdb

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 grdb -a claude-code

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

~/.claude/skills/grdb/SKILL.md

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

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

Вопросы о grdb

Как установить grdb в Claude Code?

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

Когда выбирать GRDB вместо SQLiteData?

GRDB нужен для сложных JOIN на четыре и более таблицы, оконных функций, требовательного к скорости сырого SQL и подписок ValueObservation. Для простых моделей с @Table или синхронизации с CloudKit авторы рекомендуют оставаться на SQLiteData.

Какие требования к проекту предъявляет скилл?

Проект должен быть написан на Swift 5.7 или новее с подключённой библиотекой GRDB.swift версии 6.0+. Минимальные поддерживаемые платформы — iOS 13 и macOS 10.15.

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

SKILL.md · MIT
---
name: grdb
description: Use when writing raw SQL with GRDB, complex joins across 4+ tables, window functions, ValueObservation for reactive queries, or dropping down from SQLiteData for performance. Direct SQLite access for iOS/macOS with type-safe queries and migrations.
---

# GRDB

Direct SQLite access using [GRDB.swift](https://github.com/groue/GRDB.swift) - type-safe Swift wrapper with full SQLite power when you need it.

## 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 |
|-----------|-----------|
| **[Getting Started](references/getting-started.md)** | Setting up DatabaseQueue or DatabasePool |
| **[Queries](references/queries.md)** | Writing raw SQL, Record types, type-safe queries |
| **[Value Observation](references/value-observation.md)** | Reactive queries, SwiftUI integration |
| **[Migrations](references/migrations.md)** | DatabaseMigrator, schema evolution |
| **[Performance](references/performance.md)** | EXPLAIN QUERY PLAN, indexing, profiling |

## When to Use GRDB vs SQLiteData

| Scenario | Use |
|----------|-----|
| Type-safe @Table models | SQLiteData |
| CloudKit sync needed | SQLiteData |
| Complex joins (4+ tables) | GRDB |
| Window functions (ROW_NUMBER, RANK) | GRDB |
| Performance-critical raw SQL | GRDB |
| Reactive queries (ValueObservation) | GRDB |

## Core Workflow

1. Choose DatabaseQueue (single connection) or DatabasePool (concurrent reads)
2. Define migrations with DatabaseMigrator
3. Create Record types (Codable, FetchableRecord, PersistableRecord)
4. Write queries with raw SQL or QueryInterface
5. Use ValueObservation for reactive updates

## Requirements

- iOS 13+, macOS 10.15+
- Swift 5.7+
- GRDB.swift 6.0+

## Common Mistakes

1. **Performance assumptions without EXPLAIN PLAN** — Assuming your query is fast or slow without checking `EXPLAIN QUERY PLAN` is guessing. Always profile queries with EXPLAIN before optimizing.

2. **Missing indexes on WHERE clauses** — Queries filtering on non-indexed columns scan the entire table. Index any column used in WHERE, JOIN, or ORDER BY clauses for large tables.

3. **Improper migration ordering** — Running migrations out of order or skipping intermediate versions breaks schema consistency. Always apply migrations sequentially; never jump versions.

4. **Record conformance shortcuts** — Not conforming Record types to `PersistableRecord` or `FetchableRecord` correctly leads to silent data loss or deserialization failures. Always implement all required protocols correctly.

5. **ValueObservation without proper cleanup** — Forgetting to cancel ValueObservation when views disappear causes memory leaks and stale data subscriptions. Store the cancellable and clean up in deinit.

© 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установок cmux-architecture manaflow-ai Скилл cmux-architecture задаёт правила разделения кода cmux на пакеты Swift, инверсии зависимостей и многопоточности Swift 6. Помогает переносить модули без циклических связей. CX Codex +1 5 100установок swift-expert https://github.com/Jeffallan Скилл swift-expert для Claude Code: архитектура, SwiftUI, async/await, акторы и тесты на Swift. Ведёт агента при написании и разборе кода под iOS и macOS. CX Codex +1 4 500установок axiom-data CharlesWiltgen Скилл axiom-data для Claude Code маршрутизирует задачи хранения данных в Apple-приложениях к справочникам по SwiftData, Core Data, GRDB, SQLiteData, CloudKit и миграциям. CX Codex +1 1 400установок axiom-concurrency CharlesWiltgen Скилл axiom-concurrency для работы с конкурентностью в приложениях на платформах Apple: акторы, @MainActor, Sendable, гонки данных. CX Codex +1 1 400установок swift Mindrally Настраивает агента на разработку приложений под iOS, macOS, watchOS и tvOS на Swift и SwiftUI с архитектурой MVVM. CX Codex +1 748установок

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

Весь набор →
reflect Команда reflect для Claude Code разбирает историю чата и настройки, а затем предлагает правки инструкций, команд и конфигурации. CX Codex +1 ★ 233звёзд репо swift-networking Скилл swift-networking помогает проектировать сетевой слой на базе Network.framework в Swift, настраивать сокеты, переключаться между Wi-Fi и сотовой сетью и разгружать главный поток. CX Codex +1 ★ 233звёзд репо ios-hig Скилл ios-hig помогает проектировать интерфейсы iOS с учётом рекомендаций Apple по доступности, визуальному оформлению и взаимодействию. Пригодится при создании экранов и проверке уже готовых элементов. CX Codex +1 ★ 233звёзд репо swift-engineer Субагент swift-engineer для Claude Code пишет код на чистом Swift без TCA: модели, сервисы, сеть и хранение в SQLite. Реализует фичи по готовому плану. CX Codex ★ 233звёзд репо swift-diagnostics Скилл swift-diagnostics помогает разбирать сбои навигации, сборки и памяти в проектах iOS и macOS. Он ведёт по диагностическим шагам до проверки исправления. CX Codex +1 ★ 233звёзд репо localization Скилл localization ведёт агента по локализации iOS-приложения: String Catalogs, формы множественного числа, форматы дат и вёрстка справа налево. CX Codex +1 ★ 233звёзд репо swiftui-advanced Скилл swiftui-advanced для Claude Code с правилами по сложным жестам, адаптивной вёрстке, выбору архитектуры и профилированию в SwiftUI. CX Codex +1 ★ 233звёзд репо haptics Помогает добавить тактильную отдачу для подтверждений, ошибок и действий пользователя в iOS-приложении. Работает с UIKit и Core Haptics. CX Codex +1 ★ 233звёзд репо

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

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