convex-crons について
convex-crons は、Convex の定期ジョブを設定する開発者向けのスキルです。スケジュールの定義、内部関数の指定、小さく再実行可能なハンドラーの作成を扱います。
主な機能
- 01convex/crons.ts でのスケジュール定義
- 02内部関数のスケジュール
- 03冪等なハンドラーの作成
- 04ダッシュボードでの予定確認
活用シーン
- 01内部関数の定期実行
- 02ジョブの再実行時の安全性確保
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ get-convex/ agent-skills --skill convex-cronsインストール後、Claude Code で/convex-cronsを入力して読み込まれたか確認します。
詳細
スケジュールジョブ(cron)を追加する
convex/crons.ts で、適切な間隔と冪等なハンドラーを使用して、内部関数を対象とする定期ジョブを定義します。
ワークフロー
- cronJobs() を使用して convex/crons.ts を作成します。
- 適切な間隔で内部関数をスケジュールします(公開 api.* は使用しないでください)。
- ハンドラーを冪等(安全に再実行可能)にし、1 回の実行を小規模に保ちます。
- ジョブがダッシュボードのスケジュールに表示されることを確認します。
ルール
- internal.* 関数をスケジュールし、api.* は使用しないでください。
- cron ハンドラーは小規模かつ冪等に保ちます。
- サブスクリプションでプッシュできるものを、短い間隔でポーリングしないでください。
コメント
Markdown 対応