DB変更を安全に進めるマイグレーションレビュースキル

---

name: database-migration-guard
description: CodexやClaude CodeでDBスキーマ変更やマイグレーションを作成・レビューする際、既存データ、互換性、ロールバック、段階的移行を確認するスキル。Alembic、Prisma、Django migrationsなどで使う。

Database Migration Guard

目的

開発環境では通るが本番データで失敗するDB変更を減らし、アプリ更新とスキーマ更新を安全な順序で進める。

手順

1. 現在のスキーマ、ORMモデル、既存マイグレーション、対象カラムの利用箇所を確認する。
2. 既存データが新しい制約を満たすか確認する。
3. 次の変更は特に慎重に扱う。
   • NOT NULL追加
   • 型変更
   • rename / drop
   • unique制約追加
   • 大量データの更新
4. 可能なら expand → migrate data → switch code → contract の段階的変更を選ぶ。
5. upgradeとdowngrade、またはロールバック手順を確認する。
6. マイグレーション生成後に自動生成内容を必ず読む。
7. 空DBだけでなく既存データがある状態を想定して検証する。
8. ORM、API、テスト、seed、fixtureなど関連箇所を確認する。

ルール

• カラム削除やrenameを、旧コードがまだ参照する可能性がある状態で即実行しない。
• 大量行更新をDDLと同時に行う場合は実行時間とロックを考慮する。
• 自動生成されたマイグレーションを無条件で信用しない。
• 本番適用コマンドを勝手に実行せず、ユーザーが求めた範囲で作成・検証する。

完了報告

変更内容、互換性上の注意、ロールバック方法、実施した検証を示す。