convex-crons

get-convex/agent-skills/convex-crons

该技能指导如何在 Convex 应用中定义定期计划任务（crons）。它提供了创建 convex/crons.ts 文件、调度内部函数（而非公共 API 函数）以及确保处理程序幂等且每次运行保持小规模的工作流程。此外，还强调了避免使用过短的轮询间隔，并建议在仪表板中验证任务是否出现。

安装量 · 446查看来源

Installation

npx skills add https://github.com/get-convex/agent-skills --skill convex-crons

技能文件

SKILL.md

最近同步 · 2026年10月15日

SKILL.md›

---
name: convex-crons
description: "Add recurring scheduled jobs (crons) to the Convex app."
---

<!-- GENERATED from convex-agents content/capabilities/crons.json — do not edit by hand. -->

# Add scheduled jobs (crons)

Define recurring jobs in convex/crons.ts targeting internal functions, with sane intervals and idempotent handlers.

## Workflow

1. Create convex/crons.ts with cronJobs().
2. Schedule internal functions (never public api.*) at the right interval.
3. Make handlers idempotent (safe to re-run); keep each run small.
4. Verify the job appears in the dashboard schedule.

## Rules

- Schedule internal.* functions, never api.*.
- Keep cron handlers small + idempotent.
- Don't poll tight intervals for things a subscription can push.