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
現在のアプリ内の Convex コンポーネントが anteater レジストリに対して古くなっているかを検出し、ユーザーの明示的な同意を得て、ビルドゲート（型チェック + next build）を通しながら、1 つずつアップグレードします。各アップグレードはゲートを通過し、スモークテストに合格してから次に進みます。
ワークフロー
- プロジェクトのルートディレクトリから
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= の場合：古くなっている各項目（コンポーネント名、インストール済みバージョン → 最新バージョン、概要、破壊的変更フラグ）を列挙し、何かを変更する前にユーザーに確認します。
- ユーザーが同意した場合：新しい ref をインストールし、各 migration.steps の変更を適用し（convex/ の編集は convex-expert に委任します）、migration.gate のすべてのコマンドを実行します。
- ゲートコマンドが失敗した場合：元に戻し（git checkout -- . または古い ref を再インストールして）、その旨を報告します。アプリを中途半端に移行した状態のままにしてはいけません。
- アップグレードが成功するたびに実行するスモークチェック（migration.smoke）をユーザーに案内します。
- 古くなっている各コンポーネントについて、1 つずつ順に繰り返します。
ルール
- ユーザーから明示的な同意を得ずにアップグレードしてはいけません。マイナーバージョンであっても例外ではありません。
- 次のコンポーネントに進む前に、コンポーネントごとにゲートを通してください。
- breaking:true のアップグレードを適用する前に、スナップショット（コミットまたはブランチ）を作成する必要があります。
- アップグレード後、ユーザーの確認なしに稼働中の *.convex.app サイトを自動で再公開してはいけません。
コメント
Markdown 対応