convex-seed について
convex-seedは、Convexのテーブルにフィクスチャデータを追加したり、一括インポートしたりするスキルです。スキーマに合わせた再実行可能なシード作成と、行数の確認を支援します。
主な機能
- 01internalMutationでフィクスチャを追加
- 02npx convex importで一括インポート
- 03シード処理を冪等化
- 04行数を確認
活用シーン
- 01開発やテスト用にテーブルへデータを追加
- 02Convexスキーマに合わせたデータをインポート
- 03シード処理を安全に再実行
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ convex/ agent-skills --skill convex-seedインストール後、Claude Code で/convex-seedを入力して読み込まれたか確認します。
詳細
データのシード/インポート
スキーマに合わせて、internalMutation のシード関数(再実行可能)または npx convex import を使ってテーブルにデータを投入します。
ワークフロー
- フィクスチャの場合:サンプル行を挿入する internalMutation を記述し、
npx convex runで実行します。 - 一括インポートの場合:データをスキーマに合わせて整形し、
npx convex importを使います。 - シード処理を冪等にします(削除してから挿入するか、upsert を使う)。これにより、安全に再実行できます。
- 行数を確認します。
ルール
- バリデーターに合わせて、internalMutation または convex import でシードデータを投入します。
- シード処理を冪等にします。
- 共有デプロイメントに秘密情報や個人情報をシードしないでください。
コメント
Markdown 対応