SuperAPI AI 工具集

scheduling

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

用途:提供基于 Cron 的定时任务与心跳自动化,用于创建、管理和监控周期性任务,并通过心跳模式让 AI 代理主动检查待办事项。

主要能力:使用 aiter cron add 创建任务,参数包括 name、projectId、command、expression,可选 notify 与 notifyChannelId;支持 list、pause、resume、trigger、logs、remove 等管理操作。Cron 表达式格式为“分 时 日 月 周”,资料给出了每 5 分钟、每小时、每日 9 点、每周一、工作日、每月 1 号等示例。

心跳机制:Cron 定期在项目终端执行命令,例如 echo "[HEARTBEAT] Check pending tasks at $(date)"。若终端中运行 AI CLI,PostToolUse 钩子识别 [HEARTBEAT] 标记并触发 heartbeat-scheduler 代理,代理读取 tasks.md、处理到期项、更新记忆并发送通知;若 AI CLI 未运行,则通过 --notify 发送系统通知。心跳代理会读取待办任务、检查编排、查看 cron 日志、检查通道并处理到期任务。

必要用法示例:aiter cron add --name "Job Name" --projectId project-123 --command "echo 'Hello from cron'" --expression "*/30 * * * *" --notify true;aiter cron list;aiter cron pause --id cron-789;aiter cron logs --id cron-789 --lines 20。

适用场景:轻量监控、标准助手、活跃开发、关键监控、仅工作时间等,资料给出了对应频率建议;也支持一次性未来任务、带 cron 的循环任务和条件任务。

限制:命令需在项目终端执行;通知需配置 notifyChannelId;资料未提供收费、价格、平台支持范围或具体效果数据。