ez-cronjob

核心用法

ez-cronjob 是一个纯文档型的故障排除技能，专门针对 Clawdbot/Moltbot 平台的 cron 定时任务系统。它不提供可执行代码，而是作为上下文知识库注入到 AI 助手的对话中，当用户遇到定时任务相关问题时，AI 能够引用其中的专业指导进行诊断和修复。

该技能覆盖了五大核心问题场景：内部 cron 工具死锁导致的超时、消息投递失败、时区配置错误、降级模型不遵循指令，以及任务卡死在错误状态。每个问题都提供了症状识别、根因分析和具体解决方案，并配有可直接使用的 CLI 命令示例。

显著优点

实战经验丰富：内容源自作者 Isaac Zarzuri 在生产环境中的真实调试经历，非理论文档，每一条建议都经过验证。

即查即用：采用问题-症状-解决方案的结构化格式，用户可快速定位问题并获取修复命令，无需通读全文。

安全零风险：纯 Markdown 文档，无可执行代码、无网络请求、无权限需求，从根本上杜绝了恶意代码执行的可能性。

配置模板完备：提供了"黄金法则"配置模板和多个完整工作示例（每日站会提醒、一次性提醒、周报等），用户可复制修改后直接使用。

潜在缺点与局限性

平台绑定性强：技能内容高度专属于 Clawdbot/Moltbot 生态系统，对使用其他定时任务系统（如 Linux crontab、AWS EventBridge、GitHub Actions 等）的用户几乎没有参考价值。

时效性依赖：Clawdbot/Moltbot 平台若更新 CLI 接口或行为，文档中的命令示例可能过时。目前版本为 1.0.0，需关注后续维护。

被动式辅助：作为文档型技能，它无法主动监控用户的 cron 任务状态或自动修复问题，仍需用户手动执行建议的命令。

作者维护规模有限：项目为个人开发者维护（T2 来源可信度），非大型社区项目，长期更新保障相对较弱。

适合的目标群体

• Clawdbot/Moltbot 活跃用户：需要配置 Telegram/WhatsApp 定时消息推送的开发者或运营人员
• 自动化运维人员：负责维护基于 Clawdbot 的自动化工作流，需要确保任务高可靠交付
• AI Agent 开发者：构建基于 Clawdbot 平台的自动化代理，需要规避常见的定时任务陷阱
• 跨时区团队协作：使用时区功能协调全球团队日程的用户

使用风险

操作风险：文档中的调试命令（如 clawdbot cron rm）具有实际破坏性，误操作可能导致定时任务被删除。建议执行前确认 job-id。

配置依赖风险：若用户未严格遵循"黄金法则"中的 --session isolated、、--tz` 等关键参数，仍可能遇到消息丢失或时区错误。

平台可用性风险：Clawdbot/Moltbot 网关服务若不可用，技能建议的修复命令（如 clawdbot gateway restart）也无法执行。

模型行为不确定性：即使嵌入 [INSTRUCTION: DO NOT USE ANY TOOLS]] 提示，降级模型的行为仍可能存在一定不可预测性。

核心用法

该 Skill 是一份针对 Clawdbot/Moltbot 生态的定时任务（cron）故障排查文档，提供从诊断到修复的完整工作流。核心用法包括：

1. 问题分类诊断：将常见故障归纳为 5 类——cron 工具死锁、消息未投递、执行时间错误、Fallback 模型违规调用工具、任务卡死状态。
2. 命令级修复方案：每类问题提供具体的 clawdbot cron 命令参数组合，强调 --session isolated、--tz 时区指定、--best-effort-deliver 等关键 flag 的用法。
3. Agent 行为约束：指导 AI Agent 使用 exec/bash 工具间接调用 clawdbot cron，避免直接调用 cron 工具导致的 10 秒超时死锁。
4. 防御性提示模板：推荐在消息前缀嵌入 [INSTRUCTION: DO NOT USE ANY TOOLS]，防止降级模型在定时任务中意外触发工具调用。

显著优点

• 生产经验沉淀：基于真实生产环境调试案例编写，非理论文档，解决方案经过验证。
• 结构化速查：提供 Golden Rule 速记、Checklist 清单、代码块对比（正确/错误用法），降低认知负荷。
• 完整工作流覆盖：从创建、测试（cron run）、日志排查（tail -f）、到核选项（删除重建）形成闭环。
• AI Agent 友好：明确区分人类用户与 AI Agent 的操作差异，避免 Agent 因工具调用策略不同而陷入死锁。

潜在局限

• 生态绑定：完全依赖 Clawdbot/Moltbot 专有命令体系，对标准 Linux cron、Kubernetes CronJob 等其他系统无参考价值。
• 时效性风险：文档中提及的网关日志路径（/tmp/clawdbot/、~/.clawdbot/logs/）和工具行为可能随版本迭代变化，需定期同步。
• 无自动化能力：纯文档型 Skill，不提供可执行的诊断脚本，故障排查仍需人工逐条执行命令。
• Fallback 模型问题依赖上游：[INSTRUCTION...] 模板仅为缓解方案，无法根治特定模型不遵循系统指令的问题。

适合人群

• Clawdbot/Moltbot 的日常运维与开发者
• 需要为 Telegram/ WhatsApp 群组配置自动化消息的社群运营者
• 编写 AI Agent 以管理定时任务的 Prompt Engineer

常规风险

• 命令注入误操作：若用户直接将未经验证的聊天 ID 或动态内容拼接到 --to 或 --message 参数，可能导致消息投递至错误频道或触发解析异常。
• 会话隔离副作用：--session isolated 虽解决投递可靠性，但会导致定时任务执行上下文与主会话状态隔离，某些依赖主会话记忆的任务可能行为异常。
• 时区配置遗漏：未显式指定 --tz 时默认 UTC，易在夏令时切换期间产生 1 小时偏差，跨洲团队需特别注意。