Cron 精确调度
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @zcwl/cron-expert-free。
技能介绍
问题从哪来
在支持 SKILL 的 Agent 里,很多人用「过一会儿提醒我」这类请求时,背后往往是 心跳(Heartbeat):有空就扫一眼,间隔常见 30~60 分钟。延迟只要略长一点,「10 分钟后叫我」就会在下一轮心跳才被执行,体感就是 提醒漂移、错过准点。本技能的核心准则写得很直接:心跳会漂移,cron 不会。
它面向的是 Agent 会话内的 硬性调度:在指定时刻触发,而不是「大概什么时候检查一下」。
技能如何工作
触发上,用户提到 cron、定时、提醒、调度,或描述「X 分钟后」「每天 9 点」「每周一」时,应优先进入本技能的调度模式。规则上有一条硬约束:延迟超过 1 分钟时禁止用 act:wait,必须改用 cron(例如 cron:add 配合一次性 at 调度)。
- 一次性提醒:推送类负载倾向 AgentTurn + 严格指令;静默记录用 systemEvent。一次性任务建议
deleteAfterRun: true,执行成功后自动删任务,避免堆积。 - 周期任务:用标准 cron 表达式或周期配置(文档强调
everyMs单位是毫秒,易错时可改用 cron 表达式)。 - 时区:调度前把用户时区写入
MEMORY.md(如Asia/Shanghai),时间戳用 ISO 8601 带偏移(如2026-02-06T21:00:00+08:00),避免「晚上 9 点」歧义。 - 自唤醒:等待超过 1 分钟的异步场景,用 Cron 并设置
wakeMode: "now"。 - 清理(Janitor):过期任务、显式
deleteAfterRun: false的一次性任务等,可由维护流程处理;创建前可先cron:list做去重。
文档还覆盖 企业微信、钉钉、飞书 等国内通道的推送提醒与失败排查思路(如 webhook、to 字段、通道切换)。
边界与注意点
精度是 分钟级,实际触发仍受网关心跳影响,文档提到大约 10~60 秒级延迟,不能当毫秒定时器用。任务状态在本机状态文件里,不能跨 Agent 实例共享;网关异常可能导致状态损坏,关键任务宜保留创建参数备份。它不替代操作系统 crontab,也不处理「每月最后一个工作日」「农历节日」这类复杂日历规则。短于 1 分钟、交互式等待更适合心跳或其它计时类技能。
使用场景
- 运维希望工作日每天早上 8 点由 Agent 写 systemEvent 巡检日志,需用 cron 表达式而非长间隔心跳
- 用户说「20 分钟后提醒我关会议」,延迟超过 1 分钟,需创建一次性 at 任务并 deleteAfterRun
- 产品同学要每天 9 点把日报摘要推到企业微信指定成员,需配置 channel 与 to 并锁定时区
- 周期任务堆积且曾设 deleteAfterRun: false,需 cron:list 核对后执行 Janitor 清理过期项
适合人员
- 负责 Agent 值班告警、要把「准点巡检」从心跳改成 cron 的 SRE
- 在企微/钉钉/飞书里接 webhook、需要定时推送到指定同事的内网协作开发
- 做多时区用户的对话 Agent,需要先确认 Asia/Shanghai 等再解析「晚上 9 点」的产品或运营
- 维护大量一次性/周期提醒,担心状态文件损坏或重复创建的任务配置维护者