关于 convex-seed
convex-seed 是用于向 Convex 表填充或导入数据的技能,面向需要准备测试数据或批量导入数据的开发者。它支持通过 internalMutation 或 npx convex import 写入,并要求重复运行安全且符合 schema。
主要功能
- 01通过 internalMutation 插入样例行
- 02使用 npx convex import 批量导入
- 03按 schema 整理数据
- 04支持幂等重复运行
- 05核对行数
适用场景
- 01为开发或测试填充样例数据
- 02将符合 schema 的数据批量导入表
- 03安全地重复执行数据填充
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ get-convex/ agent-skills --skill convex-seed安装后在 Claude Code 中输入/convex-seed确认已加载。
详细介绍
播种 / 导入数据
通过可重新运行的 internalMutation 播种函数或 npx convex import 填充表,并确保数据符合 schema。
工作流
- 对于测试数据:编写一个用于插入示例行的 internalMutation;使用
npx convex run运行。 - 对于批量导入:将数据整理为符合 schema 的格式,并使用
npx convex import。 - 确保播种操作具有幂等性(先清除再插入或执行 upsert),以便安全地重新运行。
- 验证行数。
规则
- 使用 internalMutation 或 convex import 播种,并确保符合 validators。
- 确保播种操作具有幂等性。
- 切勿将机密信息 / PII 播种到共享部署中。
评论
支持 Markdown