SuperAPI AI 工具集

create-and-cleanup-migration

通用与其它

查看项目

更新于 10-16 03:06

技能介绍

用途:驱动 ClawHub Convex 迁移从实现到生产清理的全流程,覆盖生产数据迁移、回填、破坏性清理、schema 收窄、表重塑或一次性维护函数,以及在临时 Convex 代码失效后创建、部署、运行、验证并移除它。

主要能力与用法:先阅读 convex-migration-helper,并在编辑 Convex 代码前阅读 convex/_generated/ai/guidelines.md;生产数据变更默认使用 @convex-dev/migrations。使用 clawhub-convex 确定仓库文件位置与运行时目标,使用 clawhub-production-release 处理生产部署阶段。流程分七阶段:设计迁移(判断 schema 增/迁/缩、字段清理、表清理、关系修复等,定义完成标准)、实现(参数校验、dry-run、批处理与续跑状态、破坏性写入确认令牌、幂等、测试与真实运行时验证)、本地验证(定向单测、bunx convex codegen、bunx tsc --noEmit、bun run ci:static、bun run ci:unit、本地真实 Convex 验证路径如 bunx convex dev --once)、PR/评审/合并/部署、生产 dry-run(有界批处理,直到 isDone:true 或安全上限)、生产 apply(需用户明确确认后执行)、清理 PR(移除临时函数、测试、文档、脚本与生成 API 条目)。

安全规则:未展示 dry-run 结果并在当前会话获得用户明确确认前,不得执行破坏性生产 apply;未展示 apply/验证结果并获确认前,不得移除迁移代码。先对“迁移”分类,若指定了 convex import --replace 等运维命令,不得另造迁移函数。已知部署名时应指向明确部署,不依赖通用 --prod。若影响可见性、审核、归属、计费、可安装性或公开 API 输出,须在 apply 关卡前说明。保留续跑游标、运行 ID、PR URL、部署 URL 与最终统计。

限制:资料未提供具体适用范围之外的产品、收费、价格或平台信息;若本地真实 Convex 验证受阻,需记录阻碍并在 PR 或部署计划中用等价运行时证据补偿。