atman-33 Supabase Migration Prep
Supabaseデータベースのマイグレーション前準備を自動化します。バックアップと差分マイグレーションファイルを生成します。
注意: マイグレーションは適用しません。準備のみを行います。
前提条件
ローカルでスキーマを編集済みであること:
supabase/schema.sqlなどのローカルファイルを編集- または
supabase/migrations/に新規SQLファイルを追加
重要:
- このスキルは
supabase startでローカルインスタンスを起動します - Docker Composeなど他のPostgreSQLが起動中の場合、ポート競合が発生する可能性があります
- 初回実行時はDockerイメージのダウンロードで時間がかかります
実行手順
1. PROJECT-REF確認
ユーザーに確認：
- PROJECT-REF（16文字の英数字、例:
abcdefghijklmnop） - マイグレーション名（オプション、デフォルト:
schema_update）
PROJECT-REF確認方法:
- Dashboard URL:
https://supabase.com/dashboard/project/[YOUR-PROJECT-REF] - 設定: Dashboard → Settings → General → Reference ID
2. スクリプト実行
# run_in_terminal ツールを使用
bash .claude/skills/supabase-migration-prep/scripts/prepare_migration.sh <PROJECT_REF> [migration_name]
例:
bash .claude/skills/supabase-migration-prep/scripts/prepare_migration.sh abcdefghijklmnop add_profile_fields
スクリプトが自動実行：
- バックアップディレクトリ作成
- Supabase認証確認
- プロジェクトリンク
- 完全バックアップ作成（ロール、スキーマ、データを個別に取得）
- ローカルSupabaseインスタンス起動（
supabase start） - ローカルスキーマをインスタンスに適用（
supabase db reset） - ローカルとリモートの差分確認
- マイグレーションファイル生成
3. 完了報告
スクリプト出力から以下を確認してユーザーに報告：
- ✅ ロールバックアップ:
supabase/backup/roles_YYYYMMDD_HHMMSS.sql - ✅ スキーマバックアップ:
supabase/backup/schema_YYYYMMDD_HHMMSS.sql - ✅ データバックアップ:
supabase/backup/data_YYYYMMDD_HHMMSS.sql - ✅ マイグレーションファイル:
supabase/migrations/YYYYMMDDHHMMSS_<name>.sql - ⚠️ マイグレーション未適用（適用前に内容確認を推奨）
- ℹ️ ローカルインスタンス起動中（不要なら
npx supabase stopで停止）
トラブルシューティング
エラー発生時は、スクリプト出力のエラーメッセージを確認し、以下を試行：
- 認証エラー:
npx supabase loginを再実行 - リンクエラー:
npx supabase unlink後に再実行 - 差分なし: ローカルでスキーマ変更後に再実行