scheduler

Scheduled Task System

Scheduled Task FeatureBuilt into the mycc backend, takes effect automatically after starting the backend.

Trigger Words

"/scheduler"
"scheduled task"
"start scheduler"
"view scheduled tasks"
"set scheduled task"

How It Works

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

Key Points：

Scheduled tasks are part of the mycc backend
Backend running = scheduled tasks running
Backend stopped = scheduled tasks stopped
history.md is created automatically, no need to do it manually

Task Configuration

Location:.claude/skills/scheduler/tasks.md

Time Format

Type	Format	Example
Daily	`HH:MM`	`08:00`、`22:30`
Weekly	`周X HH:MM`	`周一 09:00`、`周日 20:00`
One-time	`YYYY-MM-DD HH:MM`	`2026-02-01 10:00`
Interval	`每X分钟` / `每X小时`	`每30分钟`、`每2小时`

Table Format

| 时间 | 任务 | Skill | 说明 |
|------|------|-------|------|
| 08:00 | 每日初始化 | /morning | 更新日期 |
| 每2小时 | 健康提醒 | /tell-me | 喝水活动 |
| 23:40 | 清理任务 | - | 删除过期一次性任务 |

Notes

Skill column: fill in the skill name (e.g. /tell-me), if there is no specific skill fill in -
Description column: the task description passed to the AI, you can write detailed requirements
Time tolerance: ±2 minutes allowed
Interval tasks: aligned to the hour/minute (e.g. every 2 hours = 0/2/4/6/8/10/12/14/16/18/20/22 o'clock)

User Operations

User says	AI executes
"start scheduled tasks"	Execute `/mycc` to start the backend
"stop scheduled tasks"	Stop the backend
"view scheduled tasks"	Read and display tasks.md
"add scheduled task xxx"	Edit tasks.md to add a line
"remind me xxx every day at 9 o'clock"	Add `\| 09:00 \| xxx \| /tell-me \| ... \|`

Execution History

Location:.claude/skills/scheduler/history.md(created automatically)

Automatically records each task execution:

Start time
Task name
Execution status (success/failure)

Dependencies

Skill	Purpose	Required?
`/tell-me`	Send Feishu notification	Recommended
`/mycc`	Start the backend	Required

If there is no /tell-me skill, the task can still be executed, but no notification will be sent.

FAQ

Q: The scheduled task did not execute?

Check whether the backend is running:lsof -i :18080
Check whether the time format in tasks.md is correct
Check history.md to confirm whether there is an execution record

Q: Not receiving Feishu notifications?

Check whether the /tell-me skill is configured correctly
Check whether the Feishu webhook is valid

Q: Will tasks re-execute after the backend restarts? No. Each time point is executed only once, and tasks that have already passed will not be re-executed after a restart.

Install/Upgrade

See SOP.md