mcpField
C
convex-seed

convex-seed

github.com/convexデータ・データベース6936.9k 回インストール1 日前に更新
リポジトリ

convex-seed について

convex-seedは、Convexのテーブルにフィクスチャデータを追加したり、一括インポートしたりするスキルです。スキーマに合わせた再実行可能なシード作成と、行数の確認を支援します。

主な機能

  1. 01internalMutationでフィクスチャを追加
  2. 02npx convex importで一括インポート
  3. 03シード処理を冪等化
  4. 04行数を確認

活用シーン

  1. 01開発やテスト用にテーブルへデータを追加
  2. 02Convexスキーマに合わせたデータをインポート
  3. 03シード処理を安全に再実行

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/convex/agent-skills --skill convex-seed

インストール後、Claude Code で/convex-seedを入力して読み込まれたか確認します。

詳細

データのシード/インポート

スキーマに合わせて、internalMutation のシード関数(再実行可能)または npx convex import を使ってテーブルにデータを投入します。

ワークフロー

  1. フィクスチャの場合:サンプル行を挿入する internalMutation を記述し、npx convex run で実行します。
  2. 一括インポートの場合:データをスキーマに合わせて整形し、npx convex import を使います。
  3. シード処理を冪等にします(削除してから挿入するか、upsert を使う)。これにより、安全に再実行できます。
  4. 行数を確認します。

ルール

  • バリデーターに合わせて、internalMutation または convex import でシードデータを投入します。
  • シード処理を冪等にします。
  • 共有デプロイメントに秘密情報や個人情報をシードしないでください。

コメント