技能概述
ez-cronjob 是一份面向 Clawdbot/Moltbot 用户的生产级定时任务故障排查指南，由 Isaac Zarzuri 基于实际运维经验编写，专注解决 cron 任务调度中的五大核心痛点。
核心用法
该技能不依赖代码执行，而是以文档形式提供经过验证的命令模板与排障流程。主要覆盖五个典型场景：
1. 避免 `cron` 工具死锁：使用 exec: clawdbot cron 替代直接调用 cron 工具，绕过 agent 与 gateway 间的 10 秒超时死锁
2. 确保消息可靠投递：强制使用 --session isolated 防止主会话冲突导致的消息丢失
3. 消除时区混乱：显式指定 --tz 参数（如 America/New_York），避免 UTC 默认导致的执行时间偏差
4. 控制回退模型行为：在消息体前置 [INSTRUCTION: DO NOT USE ANY TOOLS] 指令，防止小模型违规调用工具
5. 故障诊断与恢复：提供日志查询、gateway 重启、作业重建等完整运维流程
显著优点
- 实战验证：所有方案均来自生产环境调试，非理论推导
- 即查即用：提供可直接复制的命令模板，降低配置错误率
- 防御性设计：通过
--best-effort-deliver等参数实现优雅降级 - 多场景覆盖：从周期性提醒到一次性任务均有完整示例
局限性与风险
- 生态锁定：完全针对 Clawdbot/Moltbot 生态，无法迁移至其他 cron 系统
- 时效性依赖：随着平台版本迭代，部分命令语法可能失效
- 无自动修复：纯文档技能，不具备自动诊断或修复能力，仍需人工执行
- 回退模型问题：指令嵌入方案虽有效，但依赖模型对自然语言指令的遵循度
适合人群
- 使用 Clawdbot/Moltbot 进行 Telegram/WhatsApp 自动化的开发者
- 需要配置可靠定时提醒、日报、周报等场景的团队管理员
- 遭遇消息丢失、时区错误等疑难杂症的运维人员
常规风险
| 风险点 | 等级 | 说明 |
|--------|------|------|
| 消息丢失 | 中 | 未使用 `--session isolated` 时，主会话繁忙可能导致投递失败 |
| 时间漂移 | 中 | 缺少时区参数导致 UTC 与本地时间偏差 |
| 工具死锁 | 低 | 直接调用 `cron` 工具触发 10 秒超时，但可通过 `exec` 规避 |
| 模型违规 | 低 | 回退模型可能无视指令调用工具，需持续监控 |