| name | scheduled-tasks |
| description | 当用户想"按时间表反复或定点做某事并自动推送结果"时使用——创建/查看/修改/暂停/删除定时（周期）任务。触发词：定时、周期、每天、每周、每月、每隔、到点、提醒我、自动发、cron、schedule、日报/周报/月报、按时推送。指导如何用定时任务工具正确设置 cron、执行内容与投递目标。 |
定时任务管理
当用户表达"按时间表反复或定点执行某事，并把结果自动发给我/发到本会话/发到某群"的意图时，
必须用本插件提供的工具完成，不要自己编造"已创建"。
可用工具（来自「定时任务管理」插件）
create_scheduled_task(cron_expression, prompt, name, deliver_to) — 创建list_scheduled_tasks(status) — 列出（用户问"我有哪些定时任务"时用）get_scheduled_task(task_ref) — 详情 + 最近运行记录update_scheduled_task(task_ref, cron_expression?, prompt?, name?) — 修改pause_scheduled_task(task_ref) / resume_scheduled_task(task_ref) — 暂停/恢复delete_scheduled_task(task_ref) — 删除/取消
铁律（务必遵守）
- 先调用工具，再回话。 在工具返回
ok: true 之前，绝不说"已创建/已修改/已删除/已设置"。
- 创建/修改/删除类请求必须落到工具调用，不要只用文字描述应付。
- 删除/修改时若
task_ref 匹配到多个任务（返回 need_clarification），先向用户确认具体是哪一个，禁止猜删。
cron 表达式（5 段：分 时 日 月 周，Asia/Shanghai 时区）
| 需求 | cron |
|---|
| 每天 9:00 | 0 9 * * * |
| 每天 16:10 | 10 16 * * * |
| 每周一 9:00 | 0 9 * * 1 |
| 每月 1 号 8:00 | 0 8 1 * * |
| 每小时整点 | 0 * * * * |
| 每 5 分钟 | */5 * * * * |
把用户的口语时间（"每天早上九点半""每周五下午六点"）准确翻译成 cron。
prompt 要自包含
到点执行时没有当前对话上下文，所以 prompt 要写清"做什么、产出什么"，
例如"汇总今天的销售数据并生成 Markdown 日报"，而不是"汇总一下"。
结果发到哪（deliver_to，一般留空）
- 留空（默认）：自动——在飞书等渠道会话里创建 → 推回该会话；在网页里创建 → 到点生成一条
站内侧栏会话（和在「自动化」页面手动建任务一样）。绝大多数情况都留空。
- "inapp"：用户明确说"发到我的网页/站内/不要发群里"时用 → 只发站内。
- 指定别的会话（用户说"往运营群/给某某发"，而不是当前会话）：
- 先调
list_channel_conversations 拿到会话列表（含 title 和 conversation_id）；
- 按用户说的群名/对象匹配 title，取其
conversation_id；
- 作为
create_scheduled_task 的 deliver_to 传入。
不要凭空臆造 conversation_id，必须来自 list_channel_conversations。
判断"当前会话是哪个"不需要你猜——系统已按用户发消息的来源自动确定；你只在用户要发到别的会话时才需要 list + 指定。
要让任务产出并投递文件（文档/表格/PDF/PPT）
投递是自动的，你不用、也没有任何"发送文件"的工具可调；但有一条硬前提：到点执行是一次
全新、无上下文的 run，只有被 pin_to_workspace 固定到工作区的文件才会 ①留在「我的空间」
②作为附件随投递目标（站内 / 飞书 / 钉钉 / 企微 / 微信会话，按 deliver_to）一起发出。没 pin
的文件不投递、只发文字。 这与渠道无关——飞书也好、站内也好，都是这一套。
所以当用户要"生成 XX 文档并发出去"时，prompt 必须写清"生成 XX 文档并交付"（不是只"汇总一下"）。
办公技能（word/excel/ppt/pdf-editing）收尾本就会 pin_to_workspace，prompt 只要明确"要产出一个文件"
即可。例：prompt="汇总今天的工单生成 Markdown 日报文档并交付"。
典型流程
- 用户："每天早上 9 点把昨天的工单汇总发我。"
- 你：调用
create_scheduled_task(cron_expression="0 9 * * *", prompt="汇总昨天的工单并生成简报", name="每日工单简报", deliver_to="here")。
- 工具返回
ok: true 后，再用自然语言告诉用户任务名、执行时间与投递目标。
