| name | cron |
| version | 1.4.0 |
| description | 仅在需要未来定时执行或周期执行任务时使用。通过 create_cron_job / list_cron_jobs / toggle_cron_job / delete_cron_job 管理定时任务。 |
| dependencies | {"tools":["create_cron_job","list_cron_jobs","toggle_cron_job","delete_cron_job"]} |
定时任务管理
何时使用
只有在需要未来某个时间自动执行，或按周期重复执行时使用本技能。
应该使用
- 用户要求"每天 / 每周 / 每小时"执行某件事
- 用户要求"明天 9 点 / 下周一 / 某个时间"自动提醒或执行
- 需要长期周期性通知、检查、汇报
不应使用
- 只是现在立即执行一次
- 只是当前会话中的正常回复
- 用户没有明确执行时间或周期
工具速查
| 操作 | 工具调用 |
|---|
| 查看所有任务 | list_cron_jobs() |
| 创建任务 | create_cron_job(name, cronExpression, triggerMessage, timezone) |
| 暂停任务 | toggle_cron_job(jobId, enabled=false) |
| 恢复任务 | toggle_cron_job(jobId, enabled=true) |
| 删除任务 | delete_cron_job(jobId) |
工作流程
第一步：确认必要信息
创建前必须确认以下信息，缺一不可：
- 任务名称（
name）
- 执行周期（
cronExpression，5 段 cron 表达式）
- 触发消息（
triggerMessage，任务触发时 Agent 收到的提示词）
- 时区（
timezone，可选，默认 Asia/Shanghai）
信息不全时先追问用户，不要用占位符创建任务。
第二步：创建任务
create_cron_job(
name="每日早报",
cronExpression="0 9 * * *",
triggerMessage="请获取今日财经新闻并发送摘要给用户",
timezone="Asia/Shanghai"
)
第三步：管理任务
查看所有任务：
list_cron_jobs()
暂停（从返回的任务列表中获取 jobId）：
toggle_cron_job(jobId=123, enabled=false)
恢复：
toggle_cron_job(jobId=123, enabled=true)
删除：
delete_cron_job(jobId=123)
Cron 表达式参考（5 段格式）
格式：分 时 日 月 周
0 9 * * * 每天 09:00
0 */2 * * * 每 2 小时整点
30 8 * * 1-5 工作日 08:30
0 0 * * 0 每周日零点
*/15 * * * * 每 15 分钟
0 9,18 * * * 每天 09:00 和 18:00
常见错误
- 缺少信息就创建：必须先确认周期、名称和触发消息
- 只是立即执行一次：不需要创建 cron，直接执行即可
- 时区混淆：默认
Asia/Shanghai；若用户在其他时区，明确指定
安全须知
triggerMessage 是 Agent 触发时收到的提示词，不是发给用户的消息- 避免创建执行频率极高（< 5 分钟）的任务，除非用户明确需要
