用途:scheduler 是内置在 mycc 后端的定时任务系统,用来让 Claude 按预设时间自动执行任务,例如每日初始化、定时提醒和清理过期任务。后端启动后该模块自动启动,后端运行等于定时任务运行,后端停止则任务停止。
主要能力:每分钟后检查一次 tasks.md,匹配时间后调用 Claude 执行任务,执行完成后写入 history.md 并发送通知。history.md 会自动创建,无需手动。任务支持每日(HH:MM)、每周(周X HH:MM)、一次性(YYYY-MM-DD HH:MM)和间隔(每X分钟/每X小时)四种时间格式,允许 ±2 分钟误差,间隔任务对齐到整点或整分钟。
使用方式:任务配置位于 .claude/skills/scheduler/tasks.md,采用表格格式,列为时间、任务、Skill、说明;Skill 列填 skill 名称(如 /tell-me),无特定 skill 填 -,说明列写传给 AI 的任务描述。用户可直接说“启动定时任务”“停止定时任务”“查看定时任务”“添加定时任务 xxx”“每天 9 点提醒我 xxx”,由 AI 对应执行启动后端、停止后端、读取显示 tasks.md 或编辑 tasks.md 添加任务行。
依赖:/mycc 用于启动后端,为必须项;/tell-me 用于发送飞书通知,为推荐项,若未配置该 skill,任务仍可执行但不发通知。
限制与常见问题:任务未执行时,可检查后端是否运行(lsof -i :18080)、tasks.md 时间格式是否正确,或查看 history.md 是否有执行记录;收不到飞书通知时,检查 /tell-me 配置和飞书 webhook。后端重启后不会补执行已过时间点的任务,每个时间点只执行一次。安装与升级方式资料中仅指向 SOP.md,具体内容暂未提供。