定时任务系统
定时任务功能内置在 mycc 后端，启动后端后自动生效。
触发词
- "/scheduler"
- "定时任务"
- "启动定时"
- "查看定时任务"
- "设置定时任务"
工作原理
mycc 后端启动
↓
scheduler 模块自动启动
↓
每分钟检查 tasks.md
↓
匹配时间 → 调用 Claude 执行任务
↓
执行完成 → 记录到 history.md + 发通知关键点：
- 定时任务是 mycc 后端的一部分
- 后端运行 = 定时任务运行
- 后端停止 = 定时任务停止
history.md会自动创建，无需手动
任务配置
位置：.claude/skills/scheduler/tasks.md
时间格式
| 类型 | 格式 | 示例 |
|---|---|---|
| 每日 | HH:MM | 08:00、22:30 |
| 每周 | 周X HH:MM | 周一 09:00、周日 20:00 |
| 一次性 | YYYY-MM-DD HH:MM | 2026-02-01 10:00 |
| 间隔 | 每X分钟 / 每X小时 | 每30分钟、每2小时 |
表格格式
| 时间 | 任务 | Skill | 说明 |
|------|------|-------|------|
| 08:00 | 每日初始化 | /morning | 更新日期 |
| 每2小时 | 健康提醒 | /tell-me | 喝水活动 |
| 23:40 | 清理任务 | - | 删除过期一次性任务 |注意事项
- Skill 列：填 skill 名称（如
/tell-me），无特定 skill 填- - 说明列：传给 AI 的任务描述，可以写详细需求
- 时间误差：允许 ±2 分钟
- 间隔任务：对齐到整点/整分钟（如 每2小时 = 0/2/4/6/8/10/12/14/16/18/20/22 点）
用户操作
| 用户说 | AI 执行 | |||||
|---|---|---|---|---|---|---|
| "启动定时任务" | 执行 /mycc 启动后端 | |||||
| "停止定时任务" | 停止后端 | |||||
| "查看定时任务" | 读取并显示 tasks.md | |||||
| "添加定时任务 xxx" | 编辑 tasks.md 添加一行 | |||||
| "每天 9 点提醒我 xxx" | 添加 `\ | 09:00 \ | xxx \ | /tell-me \ | ... \ | ` |
执行历史
位置：.claude/skills/scheduler/history.md（自动创建）
自动记录每次任务执行：
- 开始时间
- 任务名称
- 执行状态（成功/失败）
依赖
| Skill | 用途 | 必须？ |
|---|---|---|
/tell-me | 发送飞书通知 | 推荐 |
/mycc | 启动后端 | 必须 |
如果没有 /tell-me skill，任务仍可执行，但不会发通知。
常见问题
Q: 定时任务没有执行？
- 检查后端是否在运行：
lsof -i:18080 - 检查 tasks.md 时间格式是否正确
- 查看 history.md 确认是否有执行记录
Q: 收不到飞书通知？
- 检查
/tell-meskill 是否配置正确 - 检查飞书 webhook 是否有效
Q: 后端重启后任务会重新执行吗？ 不会。每个时间点只执行一次，重启后不会补执行已过的任务。
安装/升级
详见 SOP.md