SuperAPI AI 工具集

schedule-task

部署与运维

查看项目

更新于 10-16 01:13

技能介绍

用途:创建和管理仅执行 shell 命令的定时任务,支持 cron 表达式与一次性延迟/定时执行,任务在后台运行,输出仅写入日志。

主要能力:支持 create/add(周期任务)、once(一次性任务,可用 delay 或 runAt)、list、get、cancel、remove、pause、resume。周期任务使用标准 cron 表达式(分 时 日 月 周),延迟格式支持如 '30m'、'2h'、'1d'、'1h30m'、'2d12h'。任务输出写入 /job/logs/schedule/<id>.log。

使用方式:通过 require('/job/.pi/skills/schedule-task/scheduler.js') 调用 schedule(action, options)。创建周期任务需提供 expression、command、name,中高风险命令需 approved: true。也可用 Bash CLI:node /job/.pi/skills/schedule-task/scheduler.js --action create --expression "0 2 * * *" --command "node cleanup.js" --name "Daily cleanup"。

适用场景:周期性清理、定期数据处理、自动备份、计划维护。

限制:任务输出只记录日志,不会投递到任何频道;发送消息应使用 cron agent。不适用于需要用户交互或复杂工作流(应使用 SOP runner)。具备自主级别检查、命令审批、调度限流、shell 注入防护与可选沙箱执行。错误码包括 INVALID_CRON、APPROVAL_REQUIRED、DUPLICATE。建议先手动测试命令,临时停用优先用 pause 而非 remove。