跳到正文
FunCoding

cron

仅在需要未来定时执行或周期执行任务时使用。通过 create_cron_job / list_cron_jobs / toggle_cron_job / delete_cron_job 管理定时任务。

Star
1,157
分类
需求与规划
许可证
Apache-2.0
最近提交
2026年10月13日

mateclaw-server/src/main/resources/skills/cron/SKILL.md

在 GitHub 上查看

定时任务管理

何时使用

只有在需要未来某个时间自动执行，或按周期重复执行时使用本技能。

应该使用

  • 用户要求"每天 / 每周 / 每小时"执行某件事
  • 用户要求"明天 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 分钟）的任务，除非用户明确需要

相似的 Skill

brainstorming

OBobra/superpowers298k近 7 天新增 2,631 个 star

diagnosing-superpowers

OBobra/superpowers298k近 7 天新增 2,631 个 star

dispatching-parallel-agents

OBobra/superpowers298k近 7 天新增 2,631 个 star

using-superpowers

OBobra/superpowers298k近 7 天新增 2,631 个 star

executing-plans

OBobra/superpowers298k近 7 天新增 2,631 个 star

loop-me

MAmattpocock/skills288k近 7 天新增 10,178 个 star