mcpField
C
convex-seed

convex-seed

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

convex-seed について

convex-seedは、Convexのテーブルにデータを投入・インポートするスキルです。テストデータの準備や一括取り込みを行う開発者向けで、internalMutationまたはnpx convex importを使い、スキーマに沿った再実行可能な処理を行います。

主な機能

  1. 01internalMutationでサンプル行を挿入
  2. 02npx convex importで一括インポート
  3. 03スキーマに合うデータ形状
  4. 04再実行可能な冪等処理
  5. 05行数の確認

活用シーン

  1. 01開発やテスト用のサンプルデータを用意
  2. 02スキーマに合わせたデータを一括インポート
  3. 03データ投入処理を安全に再実行

インストール

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

$npx skills add https://github.com/get-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 でシードデータを投入します。
  • シード処理を冪等にします。
  • 共有デプロイメントに秘密情報や個人情報をシードしないでください。

コメント