cklxx 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 时，必须命中同一条记录才会更新。