life-planner-quick-add

name	life-planner-quick-add
description	快速添加日程任务，支持自然语言输入和交互确认。 用户用一句话描述任务，系统自动解析各字段，展示给用户确认，支持多轮修改后再写入表格。 触发场景： - 用户要求添加任务/日程/待办 - 用户说"添加 xxx"、"记录 xxx"、"我要 xxx"、"帮我记一下 xxx" - 用户描述一个需要做的事情 数据源：云文档/日程管理/个人日程数据

快速添加日程技能

固定配置

配置项	值
文件夹名称	日程管理
表格名称	个人日程数据

---

交互流程

Step 1: 接收用户输入

用户用自然语言描述任务，例如：

• "明天下午 3 点前提交论文初稿，大概需要 2 小时"
• "买牛奶"
• "下周之前完成论文第三章，属于论文投稿项目"

---

Step 2: 解析任务信息

根据 parsing-rules.md 解析各字段：

字段	解析逻辑
任务名称	提取核心动作 + 对象
类型	Action / Project / Habit
状态	默认"待办"
今日优先级	默认"无"
Area	关键词匹配
截止日期	解析时间表达
预计耗时	解析时长表达
所属项目	识别"属于 xxx 项目"
描述	可选，补充说明

---

Step 2.5: 判断是否需要 Cron 提醒 ⏰

触发条件（全部满足）：

1. 任务类型 = Action
2. 截止日期 已指定（非空）
3. 用户未明确说"不要提醒" / "不需要提醒"

不触发的情况：

• 类型是 Habit 或 Project
• 没有截止日期
• 截止时间已经过去
• 用户明确拒绝提醒

→ 如果满足条件，进入 Step 3.5 计算提醒时间

---

Step 3: 时间戳计算与验证 ⚠️ 重要

截止日期字段需要毫秒时间戳。禁止估算，必须使用工具精确计算！

3.1 获取当前时间

调用 session_status 获取当前日期时间。

3.2 计算毫秒时间戳

使用 exec 调用 date 命令：

TZ='Asia/Shanghai' date -d "YYYY-MM-DD HH:MM" +%s%3N

示例：

# 今天 19:00
TZ='Asia/Shanghai' date -d "2026-03-20 19:00" +%s%3N
# 返回：1774004400000

3.3 反向验证（必须执行）

将时间戳转换回日期，验证是否正确：

TZ='Asia/Shanghai' date -d @时间戳秒数

示例：

TZ='Asia/Shanghai' date -d @1774004400
# 返回：2026 年 03 月 20 日 星期五 19:00:00 CST

3.4 验证逻辑

预期日期时间 vs 反向验证结果
├─ 一致 → ✅ 时间戳正确，继续
└─ 不一致 → ❌ 重新计算

---

Step 3.5: 计算 Cron 提醒时间 ⏰

仅当 Step 2.5 判断需要提醒时执行

提醒时间规则

截止时间距离当前时间	提醒提前量
> 24 小时	提前 30 分钟
1-24 小时	提前 15 分钟
< 1 小时	提前 10 分钟

计算方式

1. 获取当前时间戳（毫秒）
2. 计算时间差 = 截止时间戳 - 当前时间戳
3. 根据时间差选择提前量
4. 提醒时间戳 = 截止时间戳 - 提前量（毫秒）

# 示例：提前 15 分钟（900000 毫秒）
# 先计算提醒时间的日期时间
TZ='Asia/Shanghai' date -d "2026-03-20 19:00 - 15 minutes" +%s%3N
# 返回：1774003500000

# 反向验证
TZ='Asia/Shanghai' date -d @1774003500
# 返回：2026 年 03 月 20 日 星期五 18:45:00 CST

不创建提醒的情况

• 提醒时间已过（提醒时间戳 < 当前时间戳）
• 用户明确说"不要提醒"

---

Step 4: 展示确认

格式化展示解析结果，截止日期必须显示具体日期时间：

无提醒时：

📝 我理解的日程信息如下：

任务名称：提交论文初稿
类型：Action
Area：科研
截止日期：明天 15:00（2026-03-21 15:00）
预计耗时：2 小时
所属项目：（未指定）

确认添加？如需修改请告诉我。

有提醒时：

📝 我理解的日程信息如下：

任务名称：建立党小组群聊
类型：Action
Area：党建
截止日期：今天 19:00（2026-03-20 19:00）

⏰ **检测到有明确截止时间，是否需要定时提醒？**
   - 提醒时间：今天 18:45（截止前 15 分钟）
   - 提醒内容："⏰ 提醒：建立党小组群聊 将在 15 分钟后截止"

回复"确认"添加任务 + 提醒，或告诉我"不需要提醒"。

⚠️ 截止日期格式要求：用户表达（具体日期时间）

这样用户可以直接检查日期是否正确。

---

Step 5: 处理用户反馈

情况 A - 用户确认：

• 用户说："好的" / "确认" / "没问题" / "对" / "ok"
• → 进入 Step 7: 写入表格（如有提醒，进入 Step 7.5 创建 cron）

情况 B - 用户修改：

• 用户说："类型改成 Project" / "时间改成 4 小时" / "这个属于论文投稿项目"
• → 更新字段，回到 Step 4 再次确认

情况 C - 用户取消：

• 用户说："算了" / "取消" / "不要了"
• → 结束流程，清除状态

情况 D - 用户拒绝提醒：

• 用户说："不需要提醒" / "不要提醒" / "不用提醒我"
• → 标记为不创建提醒，进入 Step 7 写入表格

---

Step 6: 修改处理

用户可以通过自然语言修改任意字段：

修改指令	解析
"类型改成 Project"	类型 = Project
"时间改成 4 小时"	预计耗时 = 240 分钟
"这个属于论文投稿项目"	所属项目 = 论文投稿
"截止时间改到下周五"	截止日期 = 重新计算
"Area 改成生活"	Area = 生活
"这是习惯任务"	类型 = Habit

修改后重新展示确认，循环直到用户满意。

---

Step 7: 写入表格

1. 定位数据源：

   • 列出云文档根目录 → 找到"日程管理"文件夹
   • 列出该文件夹 → 找到"个人日程数据"表格
   • 获取 app_token

2. 处理项目关联：

   • 如果指定了所属项目，查找是否已存在该 Project
   • 不存在则先创建 Project 类型记录

3. 写入记录：

   • 调用 feishu_bitable_app_table_record.create

---

Step 7.5: 创建 Cron 提醒任务 ⏰

仅当用户确认需要提醒时执行

调用方式

使用 exec 调用 OpenClaw CLI：

openclaw cron add \
  --name "任务提醒：建立党小组群聊" \
  --at "2026-03-20T18:45:00+08:00" \
  --session main \
  --system-event "⏰ 提醒：建立党小组群聊 将在 15 分钟后截止" \
  --wake now \
  --delete-after-run

参数说明

参数	说明
--name	任务名称 + 提醒标识
--at	提醒时间（ISO 8601 格式，带时区）
--session main	在主会话中执行
--system-event	提醒内容
--wake now	立即唤醒
--delete-after-run	运行后自动删除（一次性提醒）

时间格式转换

将毫秒时间戳转换为 ISO 8601 格式：

# 毫秒时间戳转 ISO 8601
TZ='Asia/Shanghai' date -d @1774003500 --iso-8601=seconds
# 返回：2026-03-20T18:45:00+08:00

错误处理

• 如果 cron 创建失败，不影响任务写入表格
• 在返回结果中告知用户提醒创建失败

---

Step 8: 返回结果

无提醒时：

✅ 已添加任务「提交论文初稿」

| 字段 | 值 |
|------|-----|
| 任务名称 | 提交论文初稿 |
| 类型 | Action |
| 状态 | 待办 |
| Area | 科研 |
| 截止日期 | 明天 15:00 |

🔗 查看表格：https://xxx.feishu.cn/base/xxx

有提醒时：

✅ 已添加任务「建立党小组群聊」

| 字段 | 值 |
|------|-----|
| 任务名称 | 建立党小组群聊 |
| 类型 | Action |
| 状态 | 待办 |
| Area | 党建 |
| 截止日期 | 今天 19:00 |

⏰ 已设置提醒：今天 18:45（截止前 15 分钟）
🔗 查看表格：https://xxx.feishu.cn/base/xxx
🔗 查看 cron 任务：`openclaw cron list`

---

时间处理示例

示例 1：今天

用户："今天晚上 7 点之前完成"

计算:
$ TZ='Asia/Shanghai' date -d "2026-03-20 19:00" +%s%3N
→ 1774004400000

验证:
$ TZ='Asia/Shanghai' date -d @1774004400
→ 2026 年 03 月 20 日 星期五 19:00:00 CST ✅

展示:
截止日期：今天 19:00（2026-03-20 19:00）

示例 2：明天

用户："明天下午 3 点"

计算:
$ TZ='Asia/Shanghai' date -d "2026-03-21 15:00" +%s%3N
→ 1774063200000

验证:
$ TZ='Asia/Shanghai' date -d @1774063200
→ 2026 年 03 月 21 日 星期六 15:00:00 CST ✅

展示:
截止日期：明天 15:00（2026-03-21 15:00）

示例 3：计算提醒时间

用户："今天晚上 7 点之前完成"（当前时间 11:00）

截止时间戳：1774004400000（19:00）
当前时间戳：1773982800000（11:00）
时间差：21600000ms = 6 小时（属于 1-24 小时范围）
提前量：15 分钟 = 900000ms

提醒时间戳：1774004400000 - 900000 = 1774003500000

计算提醒时间:
$ TZ='Asia/Shanghai' date -d "2026-03-20 19:00 - 15 minutes" +%s%3N
→ 1774003500000

验证:
$ TZ='Asia/Shanghai' date -d @1774003500
→ 2026 年 03 月 20 日 星期五 18:45:00 CST ✅

转换 ISO 8601:
$ TZ='Asia/Shanghai' date -d @1774003500 --iso-8601=seconds
→ 2026-03-20T18:45:00+08:00

展示:
⏰ 提醒时间：今天 18:45（截止前 15 分钟）

---

字段格式参考

写入表格时的字段格式：

字段名	类型	格式
任务名称	文本	字符串
类型	单选	字符串
状态	单选	字符串
今日优先级	单选	字符串
Area	单选	字符串
截止日期	日期	毫秒时间戳（必须精确计算）
预计耗时（分钟）	数字	整数
实际耗时（分钟）	数字	整数（留空）
描述	文本	字符串
所属项目	关联	记录 ID（record_id）

---

⚠️ 重要注意事项

1. 禁止估算时间戳：必须使用 date 命令精确计算
2. 必须反向验证：计算后必须验证时间戳是否正确
3. 展示具体日期：确认时必须显示具体日期时间，让用户可检查
4. 所属项目：需要先查找或创建 Project 类型记录
5. 用户取消：清除状态，不写入任何数据
6. 多轮修改：每次修改后都要重新确认
7. Cron 提醒：
   • 仅对 Action 类型 + 有截止日期的任务创建
   • 必须用户确认后才创建
   • 提醒时间根据截止时间动态计算
   • 使用 --delete-after-run 确保一次性提醒自动清理
   • 提醒创建失败不影响任务写入