WorkBuddy 自动化

它解决什么问题

Agent 在对话里能做的事，往往只在聊天窗口里发生：你问一句，它跑一次，窗口一关任务就结束了。一旦遇到「每天 22:30 总结当天改动」「每周一早上复习上周知识点」「每月 1 号生成数据报告」这类场景，靠人工记得来触发就变得不可靠——要么漏掉，要么在忙的时候绕过。

WorkBuddy 自动化任务配置要处理的就是这件事：把 Agent 的执行时机交给规则，而不是交给记忆。配置完成后，任务在指定时间自动跑起来，跑完即止，不需要人盯着。

它的工作方式

核心是两类调度和一份配置清单。

调度类型：

• scheduleType: "recurring" + rrule：按 RFC 5545 重复规则执行，比如每天、每周、每月，或者每 2 小时。
• scheduleType: "once" + scheduledAt：在 ISO 8601 指定时间只跑一次。

关键配置项：name 是给人看的自动化名称；prompt 是执行时真正运行的指令，且不应包含调度信息；cwds 指定任务在哪些项目目录下执行，多个目录逗号分隔；modelId 决定用哪个模型，expertId 决定激活哪个专家。status 控制处于 ACTIVE 还是 PAUSED，validFrom / validUntil 进一步限定生效区间。

创建流程大致是四步：

1. 明确任务内容、执行频率、工作目录，以及是否需要特定模型或专家。
2. 根据频率生成 RRULE 字符串。例如 FREQ=DAILY;BYHOUR=22;BYMINUTE=30 表示每天 22:30，FREQ=WEEKLY;BYDAY=MO;BYHOUR=9 表示每周一 9:00。
3. 通过 automation_update 工具以 mode="create" 创建。
4. 用 mode="list" 确认自动化已存在且处于 ACTIVE 状态。

内置模板覆盖了日报、每周复习、一次性提醒、定期备份、每日简报等常见场景，可以直接改成自己的参数。管理上也是同一套工具：view 看详情、update 改配置或暂停恢复、delete 删除。

注意点与边界

• prompt 必须自包含。自动化触发时人可能不在场，不要写「请参考之前的讨论」，要把所需背景完整写进去。
• 时区按服务器时区算，默认 GMT+8。BYHOUR=22 指北京时间 22 点，跨时区部署时要明确这一点。
• 先手动跑一遍再启用定时。确认输出符合预期后，再让规则接管。
• 临时任务用有效期兜底。validFrom / validUntil 可以避免一次活动结束后自动化仍在后台长期运行。
• 删除只能用 automation_update，不要走数据库或文件系统直接操作，否则状态会不一致。

换句话说，这套配置适合边界清晰、时间固定的重复性工作。任务本身需要交互式判断、或者执行时长波动很大的场景，仍然需要人在中间做确认。