@artale/pi-cron

为AI Agent提供持久化类Cron任务调度与提醒能力

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:@artale/pi-cron。
它的用途是:为AI Agent提供持久化类Cron任务调度与提醒能力
详细介绍见:https://321skill.com/skills/artale-pi-cron/
请根据该页面的说明完成安装。

使用示例

“帮我设置每天早上9点提醒我查看昨日业务数据的定时任务”,它会自动生成对应Cron配置并调用pi-cron注册持久化任务,到点自动触发提醒。

对AI说:“帮我新增每周五下午6点自动生成本周工作周报的周期任务”,它会按规则配置调度逻辑,即使Agent重启任务也不会丢失。

介绍

当前AI Agent应用普遍缺乏稳定可靠的定时任务能力,常规内存级定时逻辑易因进程重启、服务中断丢失任务配置,难以支撑长期提醒、周期性任务执行等需求,开发者往往需要自行实现调度逻辑与持久化存储,额外增加了开发成本。 通过npm安装该包后,即可在AI Agent项目中引入使用,按照标准Cron语法配置调度规则,绑定对应任务执行逻辑即可完成注册,内置持久化能力会自动存储任务配置,支持灵活新增、编辑、删除定时任务,也可配置一次性触发的提醒类任务。 适合开发AI Agent应用的个人开发者、小团队,尤其是需要为个人AI助理、自动化工作流Agent、智能助手类产品添加定时能力的创作者,无需从零搭建调度系统。 使用时需注意配置正确的时区参数,避免因时区偏差导致任务执行时间不符合预期,生产环境建议搭配任务执行日志监控,及时发现任务执行失败的情况,若有自定义存储需求可自行对接适配的存储介质。

核心特点

不同于通用Node.js Cron库,它专门面向AI Agent场景设计,默认内置任务持久化能力,Agent重启后已注册的任务不会丢失,无需额外开发持久化适配逻辑。

注意事项

仅面向单实例AI Agent场景设计,不适合需要分布式多节点协同调度的大规模任务集群场景。

常见问题

支持配置一次性的提醒任务吗?

支持,除了周期性Cron任务,也可配置单次定时触发的提醒类任务。

默认的任务持久化存在哪里?

默认使用本地文件存储任务配置,也支持自定义对接其他存储介质。