ai_member_xiaoxi/skills/cron-schedule/SKILL.md

name	description
cron-schedule	定时任务/提醒设置，支持一次性定时提醒和周期性cron任务。激活当用户提到"提醒我"、"定时"、"cron任务"、"多久之后通知我"等相关需求时。

定时任务设置Skill

用于快速创建定时提醒、周期性自动化任务。

激活场景

当用户提出以下需求时自动触发使用该Skill：

• "XX分钟/小时/天后提醒我XX"
• "每天/每周X XX点提醒我XX"
• "设置定时任务"
• "创建cron任务"
• "帮我加个提醒"

使用方法

1. 一次性定时提醒（执行后自动删除）

参数规则：

• 延迟时间：支持两种写法：
  • 相对时间：+30m、+2h、+1d（分别对应30分钟、2小时、1天）
  • 绝对时间：ISO格式时间字符串，例如2026-03-14T09:26:44+0800
• 提醒内容：需要通知用户的具体消息，统一前缀为⏰
• 通知对象：支持基于飞书user_id发送，格式为user:<用户user_id>，用户user_id可从员工列表文档查询获取

示例： 用户需求："30分钟后提醒我开会" 执行命令：

openclaw cron add --at +30m --name "30分钟后开会提醒" --message "⏰ 提醒：时间到了，该去开会啦！" --announce --channel feishu --to user:<用户user_id> --tz Asia/Shanghai --delete-after-run

2. 周期性定时任务（重复执行）

参数规则：

• cron表达式：标准cron格式 分 时 日 月 周，例如0 8 * * *表示每天8点
• 任务名称：便于识别的任务标识
• 执行内容/提醒消息：需要执行的操作或通知内容，统一前缀为⏰
• 通知对象：支持基于飞书user_id发送，格式为user:<用户user_id>，用户user_id可从员工列表文档查询获取

示例： 用户需求："每天早上8点提醒我备份数据" 执行命令：

openclaw cron add --cron "0 8 * * *" --name "每日8点数据备份提醒" --message "⏰ 每日提醒：请执行当日数据备份操作~" --announce --channel feishu --to user:<用户user_id> --tz Asia/Shanghai

强制规则（必须遵守）

1. 飞书消息通知支持基于用户user_id发送，格式为user:<用户user_id>，用户user_id可从/root/.openclaw/skills/lark-send-message-as-bot/vala_users_list.md查询获取
2. 时区强制指定为Asia/Shanghai，避免时间计算错误
3. 一次性提醒必须加--delete-after-run参数，执行后自动清理过期任务
4. 创建任务完成后必须按固定格式回复用户：

✅ 定时任务已创建成功！
- 任务ID：`{任务ID}`
- 触发时间：{本地时间}（{时间说明，如"10分钟后"、"每天8点"}）
- 通知对象：{用户姓名/标识}
- 通知内容：`{通知消息}`
- 执行后自动删除：{是/否}

5. 不允许创建执行破坏性操作的定时任务
6. 通知消息统一使用⏰ 开头，保持格式一致

任务管理常用命令

• 查看所有定时任务：openclaw cron list
• 删除指定任务：openclaw cron rm <任务ID>
• 手动执行验证任务：openclaw cron run <任务ID>
• 查看任务执行状态：openclaw cron status <任务ID>