cron

name	cron
description	定时任务与提醒管理：创建定时提醒、周期执行任务、管理闹钟与计划。支持 cron 表达式、固定间隔和一次性定时。当用户需要定时提醒、周期执行、计划任务或查看任务历史时触发此技能。
tools	cron
metadata	{"category":"tools","tree_id":"system/cron","tree_group":"system","min_tier":"task_light","approval_type":"plan_confirm","emoji":"⏰","enabled_when":"always","file_access":"none","scope_check":"none","security_level":"sandboxed","policy_groups":["group:system"],"profiles":["full"],"wizard_group":"system","sort_order":11,"intent_keywords":{"zh":["定时","提醒","提示我","闹钟","定时器","周期","循环","定时提醒","每天","每小时","每分钟","计划任务","定时任务","cron","每隔","分钟后","小时后","天后","稍后","一会儿","等会","待会","到点"],"en":["schedule","reminder","remind me","timer","alarm","cron","periodic","recurring","every hour","every day","every minute","scheduled task","later","in a minute","in an hour","after"]},"intent_priority":10,"related_tools":["bash","system_notify"],"scene_hint":"定时提醒→cron.create(prompt 模式+省略 command)；周期执行→schedule 用 cron 表达式；验证→下一轮 cron.list 查看","summary":"Manage scheduled tasks, reminders, and periodic automation","tool_description":"定时任务管理工具。Actions: list(列出), create(创建), update(更新), delete(删除), get(详情)。command 仅限真实系统可执行文件；触发 agent 能力(通知/发消息/写文件)必须用 prompt 模式并省略 command。","tool_input_schema":{"type":"object","properties":{"action":{"type":"string","enum":["list","create","update","delete","get"],"description":"Cron action"},"job_id":{"type":"string","description":"Job ID (get/update/delete)"},"name":{"type":"string","description":"Job name (create/update)"},"schedule":{"type":"string","description":"Cron expression or 'at:<RFC3339>' (create/update)"},"command":{"type":"string","description":"真实系统可执行文件路径 (例如 /usr/bin/afplay)。与 prompt 互斥。agent 工具名(system_notify/send_media/write_file 等)不是可执行文件，请勿填入此字段。"},"prompt":{"type":"string","description":"Agent 提示词 (例如 '请发送会议提醒通知')。与 command 互斥。需要触发 agent 能力时使用此字段。"},"agent_id":{"type":"string","description":"Agent ID，prompt 模式下可选"},"session_key":{"type":"string","description":"原会话 key；prompt 模式下建议由系统自动注入当前会话，确保触发时回写到原频道"},"channel_id":{"type":"string","description":"可选远程频道 id；省略时由 session_key 前缀推断"},"continuation_kind":{"type":"string","enum":["chat","notify","both"],"description":"投递模式：chat=助手气泡；notify=系统弹窗；both=两者"},"enabled":{"type":"boolean","description":"是否启用"}},"required":["action"]}}

Cron — 定时任务管理

核心语义

两种执行模式，必须二选一：

模式	填什么	触发时发生什么	适用场景
prompt 模式（推荐，触发 agent 能力）	prompt="..." + session_key（通常系统自动注入）	Rust daemon 把 prompt 作为新一轮消息回写到原会话，agent 按提示执行	定时发通知、定时发消息、定时派发任务
command 模式（仅限真实可执行文件）	command="<真实 shell 可执行文件>"（例如 /usr/bin/afplay）	Rust daemon 以系统事件语义把 command 文本回写到主会话（不 exec）	极少用；仅当你确实需要把一段文本当系统事件插入主会话时

常见错误：填 command="system_notify action=send ..." 或 command="send_media ..."。agent 工具（system_notify、send_media、write_file 等）不是可执行文件，daemon 不会 exec，任务会无效。如需触发通知/发消息，必须用 prompt 模式。

工作流

1. cron.list — 检查与现有计划的冲突
2. cron.create — 创建任务（最小化、可审计；一次性任务 schedule 用 at:2026-04-20T23:57:00+08:00 这类时间戳）
3. 回复用户"已创建"即完成本轮 — 触发由 Rust daemon 在调度时刻自动进行
4. 用户在下一轮询问状态 → cron.list / cron.get 查看
5. cron.update / cron.delete — 维护或退役

⚠️ 硬约束

• 创建成功即生效；{"status":"created","id":"<uuid>"} 返回后任务已进入 Rust scheduler
• 禁止在同一轮对刚创建的 id 调用 delete（会立刻取消定时任务，导致用户到点收不到通知）
• 禁止把 create + delete 当作"验证闭环"：本工具没有 status/run/runs 等验证 action，验证发生在下一轮或通过 list
• 禁止填 command 为 agent 工具名（system_notify/send_media/write_file 等）；这些是 agent 内部工具，不是可执行文件
• 如需定时触发 agent 能力（最常见场景），一律用 prompt 模式

参数用法要点

• schedule：cron 表达式（*/5 * * * *）或一次性时间戳（at:<RFC3339>）
• command / prompt：互斥，只填一个。填错会被拒绝
• session_key：prompt 模式下用于回写原会话。通常由系统自动注入当前会话 key，LLM 不必显式填；如需定向投递到其他会话才手工指定
• continuation_kind：默认 chat（写助手气泡）；需要弹窗通知用 notify 或 both

最小示例

✅ 正确：10 分钟后发送会议提醒

{
  "action": "create",
  "name": "会议提醒",
  "schedule": "at:2026-04-20T23:57:00+08:00",
  "prompt": "请通过 system_notify 发送通知：标题'会议提醒'，内容'您有一个会议即将开始'，级别 info，分类 business。",
  "continuation_kind": "notify"
}

❌ 错误：把 agent 工具名塞进 command

{
  "action": "create",
  "name": "会议提醒",
  "schedule": "at:2026-04-20T23:57:00+08:00",
  "command": "system_notify action=send level=info title=会议提醒 ..."
}

到点后 Rust daemon 只会把这串字符当系统事件文本插入主会话，不会真的调用 system_notify，用户收不到通知。

常见陷阱

• {"status":"created"} ≠ 投递成功；仅表示任务已入调度表。真实投递发生在触发时刻
• 同一 id 在同轮 create + delete = 任务被取消，等效于从未创建
• 没有 cron.status / cron.run / cron.runs 这些 action；不要推测存在
• 文件输出需要单独的 send_media 投递设计（在 prompt 模式里说明）