todo-list — 个人待办事项系统

语言规则

检测用户使用的语言，全程使用同一语言输出。 中文用户 → 读下方中文部分，全中文输出；English users → read the English section below, output in English only. 技术术语（JSON、ID 等）保留原文即可。

中文版

目标

为用户提供一个永久不丢失的待办事项管理系统。自动从聊天消息中捕获待办，智能解析时间和优先级，每日主动提醒未完成任务。

核心原则

1. 零摩擦录入 — 用户随意发一句话或一张图，系统自动识别并存储
2. 永久不丢 — 完成 = 标记 done，不等于删除。已删除 = 真正移除
3. 智能解析 — 从自然语言自动提取时间、优先级、任务内容
4. 主动提醒 — 有截止时间的未完成任务，每天 21:00 主动推送
5. 按需响应 — 用户不问不回复，避免打扰

主要职责

1. 待办录入

触发词： TODO:、帮我记录一下、记录：、待办：、加个待办、记一下、别忘了、记得提醒我、回头要做、备忘、提醒我、add todo、remind me to、don't forget、note this

模糊输入判定规则： 消息必须包含动宾结构或明确动作词才能触发录入。判断标准：

• ✅ 触发：含动词+宾语（"完成课程作业"、"买充电线"、"看完论文"）
• ✅ 触发：含明确动作+目标（"TODO: 复习期末考试"）
• ❌ 不触发：纯状态/意向陈述（"我打算吃饭"、"最近好累"、"想学 Rust"）
• ❓ 模糊时：追问而非静默录入。如"TODO: 搞一下那个东西" → 回复"你想记录什么待办？请具体说明一下任务内容"

操作优先级：如果同一条消息同时匹配录入和操作指令（如"删除这个 TODO: xxx"），优先执行操作指令（完成 > 删除 > 修改 > 录入），不创建重复待办。

矛盾请求处理：当用户消息包含矛盾指令时（如"完成了 #1 删除 #1"或"TODO: 删除所有待办"）：

• 操作间矛盾：按优先级执行第一个操作，忽略矛盾的第二个，并告知用户
• 批量操作（"删除所有"/"完成全部"）：列出受影响的项目，逐条确认，不可批量静默执行
• 越界请求（"帮我把待办同步到飞书项目"）：拒绝并提示"todo-list 仅管理本地待办，不支持外部同步"

流程：

1. 从用户消息中提取任务内容
2. 如果消息包含图片/附件，下载并保存到 ${workspace}/todo-list/attachments/
3. 解析时间要求（如有）
4. 解析优先级（如有）
5. 提取对接人（contact）（见下方对接人提取规则）
6. 提取备注（notes）（见下方备注提取规则）
7. 提取标签（tags）（见下方标签提取规则）
8. 生成唯一 ID，写入 ${workspace}/todo-list/todos.json
9. 回复用户确认（完整一行：ID + 摘要 + 优先级 + 截止时间 + 对接人 + 标签 + 备注摘要）

时间解析：

• 相对时间：今天、明天、后天、下周一、本周五、今晚、月底 等
• 绝对时间：5月20日、5-20、2026/5/20 等
• 模糊时间：尽快、ASAP、有空时 → 不设截止时间
• 精确到"天"，不支持具体小时
• 无法解析时 → 不设截止时间，不追问

优先级解析：

无法判断时默认 P1。

对接人（contact）提取规则：

从用户消息中识别对接人/负责人信息，提取到 contact 字段：

提取原则：

• 如果消息中提及多处人名，提取最直接负责该任务的人
• 无法确定时 contact 为空，不追问
• 查询输出时：有 contact → 显示 👤 对接:XXX；无 contact → 不显示

备注（notes）提取规则：

• 仅当用户明确提供备注信息时才记录，如"备注：XX"、"注意：XX"
• 禁止自动脑补备注：不要从 content 中推断、不要自行总结、不要把原文复述一遍
• 飞书文档链接等用户主动发送的参考资料可归入 notes
• notes 为空时不显示

标签（tags）提取规则：

默认标签集：工作、学习、购物、生活、健康、其他

提取方式：

1. 手动指定：用户使用 #标签名 语法，如 TODO: 完成报告 #工作 → tags: ["工作"]
2. 关键词映射：从消息内容中识别名词类别关键词，自动映射到默认标签：

3. 无匹配：当消息中没有可识别的类别关键词且用户未手动指定标签时，tags 为空数组 []
4. 多标签：一条待办可以有多个标签，如 TODO: 买体检套餐 #健康 #购物 → tags: ["健康", "购物"]
5. 自定义标签：用户可以使用 #标签名 指定不在默认集中的标签，如 TODO: 修复 bug #前端 → tags: ["前端"]

附件处理：

• 图片/文件：下载到 ${workspace}/todo-list/attachments/{todoId}_{原文件名}
• json 中记录 attachments: [{path, type}]，type 枚举：image（图片）、file（其他文件）
• 同时有文字和图片时，两者都存储

附件清理机制：

• 每次操作 todos.json 时（录入、完成、删除、修改等），检查 attachments/ 目录中是否存在已删除 todo 的附件
• 如果该附件关联的 todo 已被删除超过 7 天（根据 todo 的删除时间戳判断），则自动清理该附件文件
• 清理日志追加到 ${workspace}/todo-list/cleanup.log

2. 待办查询

触发词： TODOLIST、待办列表、查看待办、看看待办、我有哪些待办、今天还有哪些未完成、还有什么没做、今天还要干嘛、今天的事做完了没、我的清单、my todos、todo list、what's pending、show todos

查询模式：

• 无条件 → 所有未完成待办，按截止时间升序（无截止排最后），同截止时间再按优先级排序（P0 > P1 > P2 > P3）
• 按日期 → "周一的 todo"、"5月18日的待办"、"今天的" → 筛选 due_time 匹配该日期的未完成项
• 按时间范围 → "本周"、"本月" → 筛选 due_time 在范围内
• 按优先级 → "有哪些紧急的" → 筛选特定级别
• 按标签 → "工作相关的待办" → 筛选 tags 包含对应标签

输出格式： 表格，内容列在最前，无 emoji，备注仅用户明确提供时显示。

| 内容 | # | P | 截止 | 对接人 | 备注 |
|---|:---:|:---:|:---:|---|---|
| 完成课程作业（附实验报告） | 1 | P0 | 今天 | 小李 | |
| 看完那篇论文 | 3 | P1 | 下周一 | | |
| 取快递 | 5 | P1 | | | |

格式说明：

• 内容列置首，最重要信息优先
• 不使用 emoji（不要 🔴🟡🟠🟢），用 P 列直显优先级
• 备注/对接人为空时不显示（留空即可）
• 截止时间简洁显示：今天/明天/5/25，已过期标红
• 不显示 source_message（内容列已涵盖）

3. 待办操作

完成： "完成了 #1" 或 "TODO 完成 1" 或 "done #1" → 标记 status: done，记录 completed_at 删除： "删除 #1" 或 "TODO 删除 1" 或 "delete #1" → 回复待删除的 todo 内容摘要（ID + 内容 + 优先级），等用户确认后再移除。用户说"确认"或"删"时才执行 修改： "#1 改成明天" 或 "#1 change to tomorrow" → 更新对应字段，回复确认

可修改字段： content（内容）、due_time（截止时间）、priority（优先级）、contact（对接人）、notes（备注）、tags（标签）

修改语法：

• 字段名语法：#N due_time:明天、#N priority:P0、#N content:新的任务描述、#N contact:小李、#N notes:补充信息、#N tags:学习,生活
• 自然语言语法（同样支持）：#1 截止:明天、#1 优先级:P0、#1 内容:新的任务描述、#1 对接人:小李、#1 备注:补充信息
• 两种写法等价，系统都能识别

撤销机制：

• 用户说"撤销"或"undo"时，恢复到 todos.json.bak 中的上一版本
• 仅支持单步 undo：连续两次 undo 时，第二次 undo 恢复到 bak 之前的版本（即 bak 文件中存储的状态，不会继续回退到更早版本）
• undo 后的新操作：undo 之后再执行任何新操作（录入/完成/删除/修改），新操作会覆盖 todos.json.bak，之前的 undo 状态不可再恢复
• 简言之：永远只能撤销最近一次操作，undo 不是无限回退栈

4. 每日提醒

• 时间： 每天 21:00

• 配置方式（具体步骤）：

  使用 OpenClaw cron 创建每日提醒任务，最小步骤如下：

  1. 创建 cron 任务，调度规则为 0 21 * * *（每天 21:00）
  2. cron 任务触发时执行以下流程： a. 读取 ${workspace}/todo-list/todos.json b. 筛选条件：status != "done" 且 due_time != null c. 按截止时间升序排序（无截止排最后），同截止时间再按优先级排序（P0 > P1 > P2 > P3） d. 如有匹配项，生成紧凑列表消息并推送到用户聊天 e. 如无匹配项，不推送 f. 更新 last_reminder_at 为当前时间
  3. 推送消息末尾附操作指引：回复"完成 #N"标记完成 · 回复"TODOLIST"查看全部 · 回复"#N due_time:X"修改 · 回复"撤销"恢复最近操作
  4. cron 命令示例：openclaw cron add --schedule "0 21 * * *" --task "Read todos.json, filter pending items with due_time, push reminder if any"

• 降级策略： cron 不可用或执行失败时，在下次用户交互时补充推送未提醒项（检查 last_reminder_at，若超过 24 小时则补推）

数据结构

存储文件：${workspace}/todo-list/todos.json（workspace 为当前 OpenClaw 工作目录）

{
  "version": 2,
  "todos": [
    {
      "id": 1,
      "content": "完成课程作业",
      "status": "pending",
      "priority": "P0",
      "due_time": "2026-05-16",
      "contact": "小李",
      "notes": "需要附上实验报告",
      "tags": ["学习"],
      "created_at": "2026-05-16T09:30:00+08:00",
      "completed_at": null,
      "deleted_at": null,
      "attachments": [],
      "source_message": "TODO:今天下班前完成课程作业，对接人小李，需要附上实验报告"
    }
  ],
  "last_reminder_at": "2026-05-16T21:00:00+08:00"
}

字段说明：

• id: 自增整数，不重复使用
• content: 任务内容（纯文本摘要）
• status: pending | done
• priority: P0 | P1 | P2 | P3
• due_time: 截止日期 YYYY-MM-DD，可为 null
• contact: 对接人/负责人姓名（可选，无则为空字符串 ""）
• notes: 备注信息，含补充说明、参考链接等（可选，无则为空字符串 ""）
• tags: 标签数组，用于分类和筛选（如 ["工作", "bug"]），可为空数组
• created_at: 创建时间 ISO 8601
• completed_at: 完成时间 ISO 8601，完成时填入
• deleted_at: 删除时间 ISO 8601，删除时填入（用于附件 7 天清理判断）
• attachments: [{path, type}] 附件列表
• source_message: 原始消息内容（完整保留，永不修改）
• last_reminder_at: 上次提醒时间 ISO 8601（用于降级补推）

并发安全

写入 todos.json 时采用原子写模式：先写入临时文件 todos.json.tmp，写入成功后 mv（rename）替换原文件。避免两个 session 同时写导致数据丢失。

约束

• 存储路径：${workspace}/todo-list/（相对于当前工作目录）
• 附件路径：${workspace}/todo-list/attachments/
• ID 自增，已删除的 ID 不重复使用
• 不修改用户消息原文
• 删除操作必须二次确认
• 时间解析精确到天
• todos.json 或目录不存在时自动创建
• 写入 json 前自动备份上一版本到 todos.json.bak
• 读取 json 解析失败时，尝试使用 todos.json.bak 恢复
• 删除 todo 后，记录 deleted_at 时间戳，attachments 目录中的文件保留 7 天后自动清理（避免误删后无法恢复）
• 每次操作 todos.json 时检查是否有超过 7 天的已删除 todo 附件，有则清理
• Schema 升级：读取时检查 version 字段，若不匹配当前版本，执行迁移（如新增字段填默认值）并写回

English Version

This skill is written in Chinese. For full details, please read the Chinese section above. You can ask AI to translate the Chinese section if needed.

Summary

todo-list-promax — Personal todo management system with permanent storage, smart categorization, and daily reminders.

Core Principles

1. Zero-friction input — Auto-capture from casual messages or images
2. Permanent storage — Done ≠ delete; deleted = actually removed
3. Smart parsing — Auto-extract time, priority, tags from natural language
4. Daily reminders — Push unfinished tasks at 21:00 via cron
5. On-demand — Don't disturb unless asked

Key Features

Modify Syntax

• Field name syntax: #1 due_time:明天, #1 priority:P0, #1 content:新内容, #1 contact:小李, #1 notes:补充说明, #1 tags:学习,生活
• Natural language also supported: #1 截止:明天, #1 优先级:P0, #1 内容:新内容, #1 对接人:小李
• Both are equivalent

Undo Specification

• Single-step only: second consecutive undo restores to the bak version (no further rollback)
• After undo, any new operation overwrites bak — previous undo state is lost
• In short: always only the most recent operation can be undone

Data Schema

{
  "id": 1, "content": "...", "status": "pending|done",
  "priority": "P0|P1|P2|P3", "due_time": "YYYY-MM-DD|null",
  "contact": "string (optional)", "notes": "string (optional)",
  "tags": [], "created_at": "ISO8601", "completed_at": null,
  "deleted_at": null, "attachments": [{"path":"","type":"image|file"}],
  "source_message": "..."
}

Cron Setup (Minimal Steps)

1. Create cron: 0 21 * * *
2. On trigger: read todos.json → filter status != "done" AND due_time != null → sort by due_time ascending, then by priority → push if any → update last_reminder_at
3. Append action guide to push message

Constraints

• Atomic writes (write to .tmp then mv)
• Auto-backup to todos.json.bak before writes
• Auto-recover from .bak on parse failure
• Deleted todo attachments retained 7 days then auto-cleaned
• Schema migration on version mismatch