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

supabase-migration-assistant — команда для Claude Code

Создаёт и проверяет миграции базы данных Supabase. Помогает генерировать SQL, обновлять типы TypeScript и готовить откат изменений.

Установить в Claude Code · Через claude-code-templates Все способы и платформы ↓
npx claude-code-templates@latest --command database/supabase-migration-assistant
Открыть на GitHub

Что делает supabase-migration-assistant

Команда автоматизирует работу со схемой базы данных Supabase. Сначала она сканирует существующие .sql файлы и незакоммиченные правки через git diff. Затем формирует план: создание таблиц, изменение колонок, сиды или откат.

По плану генерируются SQL-скрипты, тесты целостности и типы TypeScript для синхронизации со схемами клиента. Для применения изменений команда обращается к MCP-серверу Supabase. Без настроенного MCP-сервера применить миграцию напрямую в базу не получится.

В сценарий входят dry-run валидация, проверка ограничений базы и генерация процедуры отката. Для работы ассистенту требуются инструменты Read, Write, Edit и Bash.

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

  • сгенерировать SQL-миграцию для создания или изменения таблиц
  • синхронизировать типы TypeScript со схемой базы данных
  • составить и проверить сценарий отката изменений
  • протестировать миграцию на тестовых данных перед применением
  • заполнить базу начальными данными через сид-скрипт

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

  • /supabase-migration-assistant --create Добавь таблицу profiles с полями id, username и avatar_url
  • /supabase-migration-assistant --alter Добавь колонку status в таблицу orders
  • /supabase-migration-assistant --rollback Подготовь откат последней миграции схемы

Как установить supabase-migration-assistant

1Через claude-code-templates

npx claude-code-templates@latest --command database/supabase-migration-assistant

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

.claude/commands/supabase-migration-assistant.md

Вызов — /supabase-migration-assistant. Для всех проектов — ~/.claude/commands/

Вопросы о supabase-migration-assistant

Как установить supabase-migration-assistant в Claude Code?

Выполните команду npx claude-code-templates@latest --command database/supabase-migration-assistant или сохраните файл команды по пути .claude/commands/supabase-migration-assistant.md.

Что делает supabase-migration-assistant?

Команда анализирует текущие SQL-файлы проекта, генерирует миграции Supabase, создаёт TypeScript-типы и проверяет безопасность схемы перед применением.

Какие инструменты и доступы нужны для работы команды?

Для работы требуются разрешения Read, Write, Edit и Bash в окружении Claude Code. Для применения миграций к проекту используется MCP-сервер Supabase.

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

supabase-migration-assistant.md · MIT
---
allowed-tools: Read, Write, Edit, Bash
argument-hint: "[migration-type] | --create | --alter | --seed | --rollback"
description: Generate and manage Supabase database migrations with automated testing and validation
---

# Supabase Migration Assistant

Generate and manage Supabase migrations with comprehensive testing and validation: **$ARGUMENTS**

## Current Migration Context

- Supabase project: MCP integration for migration management and validation
- Migration files: !`find . -name "*migrations*" -type d -o -name "*.sql" | head -5` existing migration structure
- Schema version: Current database schema state and migration history
- Local changes: !`git diff --name-only | grep -E "\\.sql$|\\.ts$" | head -3` pending database modifications

## Task

Execute comprehensive migration management with automated validation and testing:

**Migration Type**: Use $ARGUMENTS to specify table creation, schema alterations, data seeding, or migration rollback

**Migration Management Framework**:
1. **Migration Planning** - Analyze schema requirements, design migration strategy, identify dependencies, plan rollback procedures
2. **Code Generation** - Generate migration SQL files, create TypeScript types, implement safety checks, optimize execution order
3. **Validation Testing** - Test migration on development data, validate schema changes, verify data integrity, check constraint violations
4. **Supabase Integration** - Apply migrations via MCP server, monitor execution status, handle error conditions, validate final state
5. **Type Generation** - Generate TypeScript types, update application interfaces, sync with client-side schemas, maintain type safety
6. **Rollback Strategy** - Create rollback migrations, test rollback procedures, implement data preservation, validate recovery process

**Advanced Features**: Automated type generation, migration testing, performance impact analysis, team collaboration, CI/CD integration.

**Safety Measures**: Pre-migration backups, dry-run validation, rollback testing, data integrity checks, performance monitoring.

**Output**: Complete migration suite with SQL files, TypeScript types, test validation, rollback procedures, and deployment documentation.

© davila7 · MIT · davila7/claude-code-templates

Похожие слэш-команды

Все слэш-команды по теме «Данные и базы» →

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

Весь набор →
test-runner Хук запускает тесты сразу после того, как Claude изменил файл. Полезен, если не хочется вручную гонять проверки после каждой правки. 1 027установок supabase-performance-optimizer Слэш-команда для Claude, которая находит медленные запросы и лишние индексы в базе Supabase и предлагает план оптимизации. 1 026установок design-database-schema Команда проектирует структуру базы данных с учётом связей, ограничений и запросов. Она пригодится при создании схемы или пересмотре существующей. 1 021установок supabase-security-audit Слэш-команда прогоняет аудит безопасности проекта на Supabase: проверяет RLS-политики, права ролей, ключи API и настройки аутентификации. 1 020установок create-pr Команда создаёт ветку, форматирует изменённые файлы, делит работу на логичные коммиты и открывает pull request. Подходит для завершения Git-задачи из Claude Code. 964установок supabase-type-generator Слэш-команда генерирует TypeScript-типы из схемы Supabase и следит за её изменениями. Пригодится, когда схема живёт своей жизнью, а типы в проекте устарели. 948установок start Разбивает список задач или файл с требованиями на атомарные задачи, проверяет зависимости и собирает план выполнения. 945установок nextjs-component-generator Команда создаёт компоненты Next.js на TypeScript с учётом структуры проекта. Задайте имя и тип: клиентский, серверный, страница или макет. 935установок

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

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