SuperAPI AI 工具集

scheduled-tasks

智能体与模型

查看项目

更新于 10-16 02:36

技能介绍

用途:在 Claude Code 会话内调度周期性任务,并实现 Agentic Heartbeat 模式,让智能体生态在后台持续自检与维护。

主要能力:通过 /loop 斜杠命令按间隔或每日时间触发提示词,例如 /loop 5m <prompt>、/loop 2h <prompt>、/loop at 8:00am <prompt>,也可链式运行其他斜杠命令(如 /loop 20m /review-pr 1234)。底层接口为 CronCreate、CronList、CronDelete,支持标准 5 字段 cron 表达式。心跳模式强调先做廉价文件读取(HEARTBEAT.md、agent-health.json、内存文件大小、TaskList 卡住任务),全部健康则返回 HEARTBEAT_OK 而不调用 LLM,仅在异常时调用模型,可降低 60-80% 成本。

使用方式:用 CronCreate({ schedule: '*/30 * * * *', task: '...' }) 注册任务,CronList() 查看,CronDelete({ id: '...' }) 删除。替换任务时应先 CronCreate 再 CronDelete,避免调度空窗。建议加入每 2 天自动重注册任务(0 0 */2 * *)以防 3 天静默过期。

限制:所有循环为会话级,终端关闭、/clear 或重启后永久丢失,需手动或由 heartbeat-orchestrator 重新注册;每会话最多 50 个并发任务,建议不超过 10 个;任务创建 3 天后静默自删;仅在 Claude 空闲时触发,错过不补发;存在最多 10% 周期(上限 15 分钟)的抖动;使用本地时区;不支持 L、W、? 及 MON 等扩展语法。需要跨终端持久化时应改用操作系统 cron、GitHub Actions 或桌面级定时任务。

适用场景:会话内的心跳监控、索引重建、内存轮换检查、晨间简报、上下文清理提醒等。时间敏感告警、生产级备份部署等不适合使用本技能。