migration-helper
Migration Helper 是 Convex agent-skills 中的迁移技能,用于在 Convex 中安全地规划并执行数据库 schema 迁移,涵盖新增字段、新建表以及数据转换等场景。它强调 Convex 不会自动迁移数据,并区分“安全变更”与“破坏性变更”:新增可选字段、新表、新索引通常无需迁移;新增必填字段、修改字段类型或结构、拆表并表、重命名字段、从嵌套数据转为关系型数据则需要编写迁移代码。技能给出分步流程,例如先添加可选字段,再通过 internalMutation 回填数据,之后把字段改为必填;也提供批量处理、cron 定时迁移、双写模式等零停机迁移模式,以及用于验证迁移进度的查询。它适用于需要在应用持续运行的情况下调整 Convex schema 并迁移既有数据的开发者。