AIKraft/Skills/firebase-data-connect

firebase-data-connect

Создаёт и разворачивает бэкенды Firebase Data Connect на PostgreSQL с GraphQL-схемой и типобезопасными SDK. Полезен при работе с реляционными базами данных, запросами, транзакциями и настройкой авторизации в Firebase.

GOGoogle official Разработка ★ 462

Что делает навык

Firebase SQL Connect (ранее Data Connect) — это сервис реляционных баз данных на базе Cloud SQL для PostgreSQL, предоставляющий GraphQL-схему, автоматически генерируемые запросы и типобезопасные SDK. Он решает задачи создания бэкендов с поддержкой CRUD, транзакций, авторизации и сложных запросов к реляционным данным.

Когда применять

  • Создание типобезопасных API для веб-приложений (TypeScript), Android (Kotlin) или iOS (Swift) с использованием автоматически сгенерированных SDK.
  • Реализация сложных реляционных запросов, включая транзакции, апсерты (_upsert) и фильтрацию, с использованием Native GraphQL.
  • Настройка авторизации на уровне строк и публичного доступа к данным с помощью директив @auth, @check и @redact.
  • Использование расширенных возможностей PostgreSQL, таких как PostGIS или оконные функции, через Native SQL.

Как работает

  1. Определите модель данных в файле schema/schema.gql, используя типы GraphQL, директивы @table, @col и отношения (@ref).
  2. Напишите запросы (queries.gql) и мутации (mutations.gql) в папке connector/, добавив логику авторизации и транзакций.
  3. Настройте генерацию SDK в connector.yaml, указав целевые платформы (javascriptSdk, kotlinSdk, swiftSdk) и директории вывода.
  4. Запустите npx -y firebase-tools@latest dataconnect:compile для проверки корректности схемы и операций.
  5. Сгенерируйте типобезопасный код клиента командой npx -y firebase-tools@latest dataconnect:sdk:generate.
  6. Для локальной разработки запустите эмулятор через npx -y firebase-tools@latest emulators:start --only dataconnect и протестируйте приложение.

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

Создай GraphQL-схему для таблицы пользователей с полями id, name и email, используя директиву @table, и сгенерируй для неё SDK.
Напиши мутацию для обновления профиля пользователя с использованием _upsert и добавь проверку авторизации через @auth.
Реализуй транзакцию, которая создает заказ и списывает товар со склада, используя директиву @transaction и передачу данных между шагами.

Что понадобится

  • Установленный и инициализированный Firebase CLI (firebase-tools@latest).
  • Активный Firebase проект с подключенным Cloud SQL для PostgreSQL.
  • Локальная среда с эмулятором Firebase для разработки и тестирования.

Описание составлено по SKILL.md навыка, сверено 05.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «firebase-firebase-data-connect» из репозитория: # https://github.com/firebase/agent-skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r firebase-firebase-data-connect/ ~/.claude/skills/firebase-firebase-data-connect/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.