convex-migration-helper は何をしますか？
Convex のスキーマとデータマイグレーションを、widen-migrate-narrow パターンと @convex-dev/migrations を用いて計画します。破壊的なスキーマ変更、バックフィル、テーブル再編成、ゼロダウンタイムロールアウトに使用します。
概要
このスキルは、Convex アプリケーションにおけるデータベーススキーマとデータのマイグレーションを計画・実行するためのツールです。widen-migrate-narrow パターンと @convex-dev/migrations ライブラリを活用し、ダウンタイムを最小限に抑えながら安全に移行を進めることができます。
使用方法
AIエージェント（Claude Code、Cursor、Codex など）で以下のコマンドを実行してください：
npx convex-migration-helper
このコマンドは対話的なプロンプトを表示し、マイグレーションの計画とコード生成を支援します。
主な機能
- widen-migrate-narrow パターン: ゼロダウンタイムでスキーマを変更
- バックフィル: 既存データの新しいスキーマへの変換
- テーブル再編成: カラムの追加・削除・名前変更
- 破壊的変更の安全な適用: インデックス変更、型変換など
- @convex-dev/migrations の統合: スキーマ定義とマイグレーションロジックの分離
前提条件
- Convex プロジェクトがセットアップ済みであること
- Node.js 16 以上がインストール済みであること
詳細
詳しい使い方やベストプラクティスについては、公式ドキュメント を参照してください。