关于 convex-check-updates
convex-check-updates 会对照 anteater registry 检查应用中的 Convex 组件，并逐个引导经同意的升级。它适用于维护 Convex 应用的团队，通过构建门禁和冒烟检查验证每次迁移。
主要功能
- 01检测过时的 Convex 组件
- 02显示已安装与当前引用
- 03升级前须获得同意
- 04通过类型检查和构建设门禁
- 05逐个处理组件迁移
- 06升级后提供冒烟检查
适用场景
- 01检查应用中的过时组件
- 02升级前审查版本变更
- 03通过构建验证升级组件
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/convex-check-updates确认已加载。
详细介绍
check-updates
根据 anteater 注册表检测当前应用中的 Convex 组件是否过时，并在获得用户明确同意后，通过构建门禁（类型检查 + next 构建）逐个升级。每次升级都要通过门禁并完成冒烟测试，才能继续下一次升级。
工作流
- 在项目根目录运行
curl -fsSL https://graceful-tiger-715.convex.site/check-updates.mjs -o /tmp/cu.mjs && node /tmp/cu.mjs。 - 如果结果为 COMPONENTS_UP_TO_DATE：告知用户；完成。
- 如果结果为 COMPONENTS_STALE=：列出每个过时条目（组件名称、已安装版本 → 当前版本、摘要、是否存在破坏性变更），并在进行任何操作前征求用户同意。
- 用户同意后：安装新的引用，并应用每个 migration.steps 变更（将 convex/ 编辑委托给 convex-expert），运行所有 migration.gate 命令。
- 如果任何门禁命令失败：回滚（git checkout -- . 或重新安装旧引用）并报告；绝不让应用处于迁移未完成的状态。
- 每次成功升级后，向用户提供 migration.smoke 中的冒烟检查，以便用户运行。
- 对每个过时组件逐个重复上述步骤。
规则
- 未获得用户明确同意，绝不升级——即使是次要版本也不行。
- 每个组件都必须单独通过门禁，才能继续下一个组件。
- breaking:true 升级在应用前必须创建快照（提交或分支）。
- 升级后，未经用户确认，不要自动重新发布正在运行的 *.convex.app 网站。
评论
支持 Markdown