mcpField
C
convex-seed

convex-seed

github.com/convex数据与数据库6936.9k 次安装1 天前更新
代码仓库

关于 convex-seed

convex-seed 是用于向 Convex 表填充测试数据或批量导入数据的技能。它指导开发者按 schema 准备数据、实现可重复执行的填充,并核对行数。

主要功能

  1. 01使用 internalMutation 填充测试数据
  2. 02通过 npx convex import 批量导入
  3. 03实现可重复执行的数据填充
  4. 04核对行数

适用场景

  1. 01为开发或测试填充表数据
  2. 02导入符合 Convex schema 的数据
  3. 03安全地重复执行数据填充

安装

复制下面的命令,在终端中运行。

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

安装后在 Claude Code 中输入/convex-seed确认已加载。

详细介绍

播种 / 导入数据

通过可重新运行的 internalMutation 播种函数或 npx convex import 填充表,并确保数据符合 schema。

工作流

  1. 对于测试数据:编写一个用于插入示例行的 internalMutation;使用 npx convex run 运行。
  2. 对于批量导入:将数据整理为符合 schema 的格式,并使用 npx convex import。
  3. 确保播种操作具有幂等性(先清除再插入或执行 upsert),以便安全地重新运行。
  4. 验证行数。

规则

  • 使用 internalMutation 或 convex import 播种,并确保符合 validators。
  • 确保播种操作具有幂等性。
  • 切勿将机密信息 / PII 播种到共享部署中。

评论

支持 Markdown