| name | lyzbcy-task-timer |
| description | 一次性任务提醒管理器。当用户要求"安排任务/排期/定时提醒/帮我规划今晚"时触发。支持按50/10节奏自动排期、批量创建cron提醒、任务完成后自动清理cron，适合频繁使用的一次性工作/学习提醒场景。 |
lyzbcy-task-timer / 任务提醒管理器
管理用户的一次性任务排期与提醒 cron 生命周期：创建 → 提醒 → 清理。
🎯 触发场景
- "帮我安排一下今晚的工作"
- "帮我排个计划，每50分钟休息10分钟"
- "我有几个任务要完成，帮我定个时间表"
- "提醒我做事" + 给出具体任务列表
📁 数据结构
<workspace>/
└── task-timer/
└── sessions/
└── <session-id>.json # 每次排期的记录
session-id 格式
YYYY-MM-DD-HHmm（如 2026-05-17-2030）
session 记录格式
{
"id": "2026-05-17-2030",
"createdAt": "2026-05-17T20:30:00+08:00",
"status": "active | completed | cancelled",
"schedule": {
"workMinutes": 50,
"breakMinutes": 10,
"advanceNoticeMinutes": 5
},
"tasks": [
{
"name": "修改PPT",
"emoji": "📊",
"durationMinutes": 30,
"index": 1
}
],
"timeline": [
{
"index": 1,
"type": "task | break | advance_notice",
"name": "修改PPT",
"emoji": "📊",
"startTime": "2026-05-17T20:12:00+08:00",
"endTime": "2026-05-17T21:02:00+08:00",
"cronJobId": "2645fe27-...",
"status": "pending | fired | skipped"
}
],
"cronJobIds": [
"2645fe27-...",
"ed63303f-..."
],
"completedAt": null
}
🔧 核心流程
1. 创建排期 (create)
输入： 用户提供任务列表（名称 + 预估耗时）
处理步骤：
- 确认当前时间（
session_status 获取或 date 命令）
- 按
workMinutes / breakMinutes 节奏自动排时间表
- 为每个节点生成 timeline 条目：
- task: 任务开始提醒
- break: 休息提醒
- advance_notice: 提前 5 分钟预警（可选，默认开启）
- 计算 ISO 时间戳
- 串行创建 cron 任务（
openclaw cron add），每个 cron 都带 --delete-after-run
- 记录所有 cronJobId 到 session 文件
- 展示排期表给用户
排期规则：
- 首个任务：从"现在 + advanceNoticeMinutes"开始
- 工作块时长 = task.durationMinutes（如果 ≤ workMinutes 则用实际时长）
- 如果 task.durationMinutes > workMinutes，拆成多个工作块，中间插休息
- 工作块后插一个 break（10min）
- break 结束前 advanceNoticeMinutes 分钟发提前提醒
cron 消息模板：
你是一个暖心的提醒助手。请用温暖、有趣的方式提醒用户：<具体提醒内容>。
要求：(1) 不要回复HEARTBEAT_OK (2) 不要解释你是谁 (3) 直接输出提醒消息
(4) 控制在2句话以内 (5) 不要新建定时任务
⚠️ cron 创建注意事项：
--at 参数必须使用 ISO 时间格式（如 2026-05-17T18:23:13+08:00）- 不支持
+55m 这种格式，必须预先计算好 ISO 时间
- 必须串行创建，并行会导致 gateway 连接冲突（WebSocket 被挤爆）
- 每个创建后 poll 确认成功再创建下一个
- 所有 cron 都带
--delete-after-run，执行后自动清理
2. 查看排期 (list)
列出当前 active 的 session 及其 timeline 状态。
openclaw cron list
3. 调整排期 (adjust)
用户反馈进度变化时：
- 任务提前完成 → 后续任务提前
- 任务需要延后 → 整体后移
- 取消某个任务 → 删除对应 cron，重排后续
调整步骤：
- 读取当前 session 文件
- 删除需要变更的 cron（
openclaw cron remove <id>）
- 重新计算 timeline
- 创建新的 cron
- 更新 session 文件
4. 完成清理 (complete)
当最后一个任务完成或用户主动结束：
- 遍历 session 中所有 cronJobIds
- 逐个删除未触发的 cron（
openclaw cron remove <id>）
- 更新 session status 为
completed
- 已
--delete-after-run 的会自动消失，无需手动删
5. 清理孤儿 (cleanup)
定期检查是否有残留的 active session，提醒用户是否清理。
📋 用户交互规范
排期确认
创建前展示排期表给用户确认：
| 时间段 | 内容 | 耗时 |
|--------|------|------|
| 20:12-21:02 | 📊 修改PPT | 50min |
| 21:02-21:12 | ☕ 休息 | 10min |
进度反馈
用户随时可以说：
- "PPT做完了" → 标记完成，调整后续
- "强化学习要延后10分钟" → 整体后移
- "VR作业不做了" → 跳过，重排
提醒风格
- 温暖、简短、有鼓励感
- 不要啰嗦，不要解释身份
- 休息提醒要催喝水/活动
- 任务开始提醒要有冲劲
🔒 约束
- 所有 cron 都是一次性的（
--delete-after-run）
- 不创建重复性 cron（那是日历/闹钟的活）
- session 文件保留历史记录，不自动删除
- 同一时间只维护一个 active session（新 create 前先 complete 旧的）
- 串行创建 cron，禁止并行
