Agent Skills: 定时任务系统

定时任务系统。内置在 mycc 后端,自动执行定时任务。触发词:"/scheduler"、"定时任务"、"启动定时"、"查看定时"

UncategorizedID: aster110/mycc/scheduler

Install this agent skill to your local

pnpm dlx add-skill https://github.com/Aster110/mycc/tree/HEAD/.claude/skills/scheduler

Skill Files

Browse the full folder contents for scheduler.

Download Skill

Loading file tree…

.claude/skills/scheduler/SKILL.md

Skill Metadata

Name
scheduler
Description
定时任务系统。内置在 mycc 后端,自动执行定时任务。触发词:"/scheduler"、"定时任务"、"启动定时"、"查看定时"

定时任务系统

定时任务功能内置在 mycc 后端,启动后端后自动生效。

触发词

  • "/scheduler"
  • "定时任务"
  • "启动定时"
  • "查看定时任务"
  • "设置定时任务"

工作原理

mycc 后端启动
    ↓
scheduler 模块自动启动
    ↓
每分钟检查 tasks.md
    ↓
匹配时间 → 调用 Claude 执行任务
    ↓
执行完成 → 记录到 history.md + 发通知

关键点

  • 定时任务是 mycc 后端的一部分
  • 后端运行 = 定时任务运行
  • 后端停止 = 定时任务停止
  • history.md 会自动创建,无需手动

任务配置

位置:.claude/skills/scheduler/tasks.md

时间格式

| 类型 | 格式 | 示例 | |------|------|------| | 每日 | HH:MM | 08:0022: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: 定时任务没有执行?

  1. 检查后端是否在运行:lsof -i :18080
  2. 检查 tasks.md 时间格式是否正确
  3. 查看 history.md 确认是否有执行记录

Q: 收不到飞书通知?

  1. 检查 /tell-me skill 是否配置正确
  2. 检查飞书 webhook 是否有效

Q: 后端重启后任务会重新执行吗? 不会。每个时间点只执行一次,重启后不会补执行已过的任务。


安装/升级

详见 SOP.md