check-updates 是一个用于管理 Convex 组件版本的技能，帮助开发者发现当前应用中固定（pinned）的 Convex 组件是否落后于推荐版本，并在受控的构建门禁下逐个升级。它主要面向使用 Convex 组件、希望保持依赖更新但又担心升级破坏应用稳定性的开发场景。
一、主要能力 （1）检测过时组件：从项目根目录运行检测脚本，对比当前应用的组件与 anteater registry 之间的版本差异。 （2）报告状态：脚本会返回 COMPONENTS_UP_TO_DATE 或 COMPONENTS_STALE 状态。若为过期状态，会列出每个过时条目的组件名、已安装版本 → 当前版本、摘要以及 breaking 标记。 （3）逐项升级：在用户明确同意后，一次只处理一个组件，安装新引用、应用每项 migration.steps 变更（涉及 convex/ 目录的编辑委托给 convex-expert），并运行所有 migration.gate 命令。 （4）回滚保护：若任一门禁命令失败，则回滚（git checkout -- . 或重装旧引用）并报告，绝不让应用停留在半迁移状态。 （5）冒烟检查：每次升级成功后，向用户提供 migration.smoke 冒烟检查命令。 （6）重复流程：对每个过时组件重复以上过程，一次一个。
二、使用方式 在项目根目录执行以下命令进行检测： 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=，则列出每个过时条目并询问用户是否升级。用户同意后，按上述逐项升级流程处理。
三、规则与限制 （1）绝不在没有用户明确同意的情况下升级，即使只是小版本。 （2）每个组件单独完成门禁后，才进入下一个组件。 （3）breaking:true 的升级需要在应用前创建快照（commit 或 branch）。 （4）升级后，未经用户确认，不要自动重新发布运行中的 *.convex.app 站点。 （5）检测脚本 URL 为 https://graceful-tiger-715.convex.site/check-updates.mjs。 （6）关于 anteater registry 的具体内容、migration.steps、migration.gate、migration.smoke 的详细定义，以及所支持 Convex 组件的完整列表，资料中暂未提供。
四、适用场景 适用于正在使用 Convex 组件、需要检查组件版本是否需要更新，并希望在安全可控的前提下逐个升级、避免升级导致应用中断或半迁移的项目。