supabase-migration-assistant — команда для Claude Code
Создаёт и проверяет миграции базы данных Supabase. Помогает генерировать SQL, обновлять типы TypeScript и готовить откат изменений.
npx claude-code-templates@latest --command database/supabase-migration-assistantЧто делает 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-assistant2Вручную: положить файлы
.claude/commands/supabase-migration-assistant.mdВызов — /supabase-migration-assistant. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/supabase-migration-assistant.mdВызов — /prompts:supabase-migration-assistant. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/supabase-migration-assistant.prompt.mdВручную: положить файлы
.gemini/commands/supabase-migration-assistant.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о 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