reminder-scheduler

一个 skill 同时覆盖两类能力：

单次提醒：延迟触发（如 30 分钟后提醒）
周期计划：维护长期提醒计划（如每周复盘）

调用

# 单次提醒：设置、查看、取消
python3 skills/reminder-scheduler/run.py set_once --delay 30m --task "喝水提醒"
python3 skills/reminder-scheduler/run.py list_once
python3 skills/reminder-scheduler/run.py cancel_once --id timer-12345

# 周期计划：创建/更新、查看、删除、到期扫描、执行后推进
python3 skills/reminder-scheduler/run.py upsert_plan --name weekly-retro --schedule "0 18 * * 5" --task "发送复盘提醒" --next-run-at 2026-03-06T10:00:00Z
python3 skills/reminder-scheduler/run.py list_plans
python3 skills/reminder-scheduler/run.py due_plans --now 2026-03-06T10:00:00Z
python3 skills/reminder-scheduler/run.py delete_plan --name weekly-retro
python3 skills/reminder-scheduler/run.py touch_plan --name weekly-retro --next-run-at 2026-03-13T10:00:00Z

参数

`set_once`

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | delay | string | 是 | 延迟时间（30s / 5m / 2h） | | task | string | 是 | 提醒内容 |

`cancel_once`

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | id | string | 是 | 单次提醒 ID |

`upsert_plan`

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | name | string | 是 | 计划名（唯一键） | | schedule | string | 是 | 周期表达式（cron 字符串） | | task | string | 是 | 提醒内容 | | next_run_at | string | 否 | 下一次执行时间（ISO8601） | | channel | string | 否 | 渠道，默认 lark | | enabled | bool | 否 | 是否启用，默认 true | | metadata | object | 否 | 扩展元数据 |

`list_plans`

无参数，返回当前所有周期计划。

`delete_plan`

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | name | string | 否 | 计划名；与 id 至少提供一个 | | id | string | 否 | 计划 ID；与 name 至少提供一个 |

当同时提供 name 和 id 时，必须命中同一条记录才会删除。

`due_plans`

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | now | string | 否 | 当前时间（ISO8601）；未提供时取系统 UTC 时间 |

`touch_plan`

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | name | string | 否 | 计划名；与 id 至少提供一个 | | id | string | 否 | 计划 ID；与 name 至少提供一个 | | next_run_at | string | 否 | 更新下一次执行时间（ISO8601） |

当同时提供 name 和 id 时，必须命中同一条记录才会更新。