C
convex-migrate
by @convexv
4.6(120)
この Skill は、稼働中の Convex アプリでスキーマを安全に変更し既存データをバックフィルします。まず新フィールドを optional にして既存行のデプロイ拒否を防ぎ、@convex-dev/migrations で移行スクリプトを書いて全行を埋め、検証が終わってから validator を必須に締めます。「フィールド変更で本番が壊れる」危険な作業を、停止もデータ損失もなしに進められる4段階の手順に変えます。
インストール方法
npx skills add https://github.com/convex/agent-skills --skill convex-migratecompare_arrows
Before / After 効果比較
1 组使用前
開発者が稼働中の Convex アプリでフィールドを直接変更し必須に設定。デプロイ後に既存行が新しい validator を満たさず本番 API がエラーになり、ロールバックして手書きスクリプトで一行ずつデータを補うしかなかった。
使用後
この Skill はまずフィールドを optional にしてデプロイを通し、@convex-dev/migrations でバックフィルを実行、前後の行数を照合して全行有効を確認してから validator を必須に締めます。停止時間はゼロです。
SKILL.md
Migrate the schema / data on a live app
Change a deployed schema without breaking existing data: stage the schema change, install @convex-dev/migrations, write a backfill that makes old rows valid, run it, and verify before tightening the validator.
Workflow
- Make the new field optional first (so deploy doesn't reject existing rows).
- Install @convex-dev/migrations; write a migration that backfills/transforms existing rows.
- Run the migration; verify all rows are valid.
- Tighten the validator (make the field required) once the backfill is complete.
Rules
- Never tighten a validator before the backfill completes — it rejects existing rows and breaks the live app.
- Add new fields as optional first, migrate, then require.
- Verify row counts before and after.
ユーザーレビュー (0)
レビューを書く
効果
使いやすさ
ドキュメント
互換性
レビューなし
統計データ
インストール数35.1K
評価4.6 / 5.0
バージョン
更新日2026年10月23日
比較事例1 件
ユーザー評価
4.6(120)
5
37%
4
43%
3
13%
2
5%
1
2%
この Skill を評価
0.0
対応プラットフォーム
🤖claude-code
タイムライン
作成2026年10月17日
最終更新2026年10月23日