supabase-schema-sync — команда для Claude Code: что делает
Команда сверяет локальную схему базы данных с удалённым проектом Supabase через MCP-сервер. Помогает быстро находить расхождения и готовить файлы миграций.
npx claude-code-templates@latest --command database/supabase-schema-syncЧто делает supabase-schema-sync
Команда запускает проверку схемы между локальным репозиторием и удалённым инстансом Supabase. Скрипт анализирует файлы schema.sql, каталог migrations, переменные окружения и недавние правки в файлах .sql и .ts. В зависимости от переданного аргумента агент скачивает схему через --pull, отправляет изменения через --push или сравнивает структуры через --diff.
Для выполнения запросов требуется настроенный MCP-сервер Supabase. При анализе команда проверяет ограничения внешних ключей, оценивает риски несовместимости и создаёт сценарии отката. Она поддерживает режим предварительного запуска, чтобы оценить изменения до применения в базе.
Какие задачи решает
- найти расхождения между локальными SQL-файлами и удалённой базой
- проверить внешние ключи и совместимость запросов перед применением схемы
- сгенерировать файлы миграций с процедурой отката
- выгрузить актуальную структуру таблиц из Supabase в проект
Примеры запросов агенту
- Запусти /supabase-schema-sync --diff, чтобы увидеть разницу в структурах таблиц.
- Выполни /supabase-schema-sync --validate перед применением миграций.
- Используй /supabase-schema-sync --pull для загрузки схемы из Supabase.
Как установить supabase-schema-sync
1Через claude-code-templates
npx claude-code-templates@latest --command database/supabase-schema-sync2Вручную: положить файлы
.claude/commands/supabase-schema-sync.mdВызов — /supabase-schema-sync. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/supabase-schema-sync.mdВызов — /prompts:supabase-schema-sync. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/supabase-schema-sync.prompt.mdВручную: положить файлы
.gemini/commands/supabase-schema-sync.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о supabase-schema-sync
Как установить supabase-schema-sync в Claude Code?
Выполните команду npx claude-code-templates@latest --command database/supabase-schema-sync или сохраните файл шаблона по пути .claude/commands/supabase-schema-sync.md.
Что делает команда supabase-schema-sync?
Она сверяет локальные SQL-файлы с удалённой базой Supabase через MCP-сервер, находит различия и помогает готовить файлы миграций.
Какие аргументы поддерживает команда?
Команде можно передать флаги --pull, --push, --diff или --validate в зависимости от нужного действия со схемой.
Исходный текст
supabase-schema-sync.md · MIT
--- allowed-tools: Read, Write, Edit, Bash argument-hint: "[action] | --pull | --push | --diff | --validate" description: Synchronize database schema with Supabase using MCP integration --- # Supabase Schema Sync Synchronize database schema between local and Supabase with comprehensive validation: **$ARGUMENTS** ## Current Supabase Context - MCP connection: Supabase MCP server with read-only access configured - Local schema: !`find . -name "schema.sql" -o -name "migrations" -type d | head -3` local database files - Project config: !`find . -name "supabase" -type d -o -name ".env*" | grep -v node_modules | head -3` configuration files - Git status: !`git status --porcelain | grep -E "\\.sql$|\\.ts$" | head -5` database-related changes ## Task Execute comprehensive schema synchronization with Supabase integration: **Sync Action**: Use $ARGUMENTS to specify pull from remote, push to remote, diff comparison, or schema validation **Schema Synchronization Framework**: 1. **MCP Integration** - Connect to Supabase via MCP server, authenticate with project credentials, validate connection status 2. **Schema Analysis** - Compare local vs remote schema, identify structural differences, analyze migration requirements, assess breaking changes 3. **Sync Operations** - Execute pull/push operations, apply schema migrations, handle conflict resolution, validate data integrity 4. **Validation Process** - Verify schema consistency, validate foreign key constraints, check index performance, test query compatibility 5. **Migration Management** - Generate migration scripts, track version history, implement rollback procedures, optimize execution order 6. **Safety Checks** - Backup critical data, validate permissions, check production impact, implement dry-run mode **Advanced Features**: Automated conflict resolution, schema version control, performance impact analysis, team collaboration workflows, CI/CD integration. **Quality Assurance**: Schema validation, data integrity checks, performance optimization, rollback readiness, team synchronization. **Output**: Complete schema sync with validation reports, migration scripts, conflict resolution, and team collaboration updates.
© davila7 · MIT · davila7/claude-code-templates
