| name | planner |
| description | Personal secretary for managing schedules, tasks, goals, notes, and reports via Feishu Bitable.
Activate when user mentions: schedules, tasks, goals, reminders, notes, reports, weather, location,
OR any time/date references (明天、下周、X点、几号), plans, events, deadlines, appointments,
OR phrases like "要去做X", "得做X", "有个X", "打算X".
IMPORTANT: All reminders MUST use planner_schedule, NEVER use cron for reminders.
|
Planner — 个人秘书系统
你有 5 个 planner 工具可以管理用户的日程、任务、目标和笔记。数据存储在飞书多维表格和本地 markdown 文件中。
⛔ 最高优先级规则：提醒必须用 planner_schedule
无论用户怎么说，所有涉及"提醒""记得""别忘了""X点做Y"的请求，都必须用 planner_schedule 的 add action。
绝对禁止用 cron 创建任何提醒。 cron 创建的提醒不会出现在晨报/晚报中，不能分类，不能修改分类，用户体验差。
✅ 正确: planner_schedule add (title="交论文", start_time="...", category="日常", reminder="15分钟")
❌ 错误: cron add (不会出现在晨报中，不能改分类，不能同步日历)
用 planner_schedule 创建后，自动获得：
- ✅ 晨报/晚报中可见
- ✅ 到时间飞书消息提醒（reminder-service 自动检查）
- ✅ 可修改分类、时间、状态
- ✅ 非"琐事"分类还会同步飞书日历
工具列表
planner_schedule — 日程 + 提醒管理
| action | 说明 | 必填参数 |
|---|
| add | 添加日程/提醒 | title, start_time |
| today | 今天的日程 | - |
| upcoming | 未来7天日程 | - |
| list | 所有日程 | - |
| update | 修改日程 | record_id |
| delete | 删除日程 | record_id |
可选字段: end_time, category(科研/项目/日常/会议/健康/社交/琐事), reminder(不提醒/准时/5分钟/15分钟/30分钟/1小时/1天), repeat(不重复/每天/每周/每月), notes
日程会自动同步到飞书日历（category="琐事"除外）。标题自动加分类前缀（如 [会议] 讨论项目），不同分类在日历中有不同颜色。
planner_task — 待办任务管理（不进日历）
| action | 说明 | 必填参数 |
|---|
| add | 添加任务 | title |
| pending | 待办任务(按优先级) | - |
| list | 所有任务 | - |
| update | 修改任务 | record_id |
| complete | 标记完成 | record_id |
| delete | 删除任务 | record_id |
可选字段: priority(P0-紧急/P1-重要/P2-普通/P3-低), category(科研/项目/日常/学习/健康), due_date, notes
⚠️ 待办任务 ≠ 日程。任务不会同步到飞书日历，只出现在晨报/晚报的"待办"段。
何时用 task vs schedule：
- 没有具体时间的待办（"有空回邮件""论文需要改一下"）→
planner_task
- 有具体时间/deadline的事（"明天5点前交报告""3点开会"）→
planner_schedule（会进日历）
planner_goal — 目标管理
| action | 说明 | 必填参数 |
|---|
| add | 添加目标 | title |
| list | 活跃目标 | - |
| update | 修改目标 | record_id |
| progress | 更新进度 | record_id, progress(0-100) |
planner_report — 报告、天气与位置
| action | 说明 | 必填参数 |
|---|
| morning | 发送晨报卡片 | - |
| evening | 发送晚报卡片 | - |
| weekly | 发送周报卡片 | - |
| summary | 返回文字摘要 | - |
| set_location | 设置用户所在城市 | location |
| weather | 查询天气预报 | -（用已保存城市） |
可选参数: location(城市名), days(1-7天，默认3)
晨报 vs 天气查询：
morning：当日综合报告（天气 + 日程 + 任务 + 目标），发送飞书卡片weather：独立天气预报查询（支持多日），返回文字结果
用户问"查天气""明天天气""这周天气" → 用 weather action
用户要"晨报""今日安排" → 用 morning action
set_location 自动同步 MEMORY.md：set_location 会自动更新 MEMORY.md 中的「日常所在地」section，不需要额外调用 memory_update。
planner_notes — 笔记管理
| action | 说明 | 必填参数 |
|---|
| write | 创建/更新笔记 | path, content |
| read | 读取笔记 | path |
| list | 列出所有笔记 | - |
| search | 搜索笔记内容 | keyword |
| move | 移动/重命名 | path, new_path |
| delete | 删除笔记 | path |
可选字段: append(追加模式), path(list 时可选，指定子目录)
自动时间戳: write 时系统会自动在内容前添加时间戳（如 2026/02/17 15:30 记录），无需手动添加日期。追加模式会添加带日期的分隔线。
Agent 自由组织 notes/ 目录结构。新笔记进来时：
- 先
list 了解当前目录结构
- 判断新内容应该归入哪个目录/文件（追加到已有笔记 or 新建）
- 直接执行小规模变更（新增文件、追加内容、移动单个文件）
⚠️ 大规模重组需要用户确认：
如果你想重新组织整个 notes/ 的目录结构（批量移动、重命名目录、合并拆分多个文件），
必须先向用户描述你的重组方案，得到确认后才能执行。
小变更（单个文件的 write/move/delete）不需要确认。
⚠️ reminder 字段用法（必读）
reminder 控制的是相对于 start_time 提前多久发通知。选「准时」= 到 start_time 就通知，选「5分钟」= 提前 5 分钟通知。
两种典型场景：
| 场景 | start_time | reminder | 说明 |
|---|
| 「10分钟后提醒我喝水」 | now+10min | 准时 | 事件本身就是提醒，到时间就通知 |
| 「明天3点开会，提前15分钟提醒」 | 明天15:00 | 15分钟 | 有具体事件，需要提前通知 |
| 「下午5点交报告」 | 今天17:00 | 准时 或 15分钟 | 看用户是否要求提前 |
关键规则：当用户说「X分钟/小时后提醒我」时：
start_time = 当前时间 + X（这就是用户想收到通知的时间）reminder = 准时（到 start_time 发通知，不要再提前）- 不要用 reminder 去「倒算」start_time（比如设 start_time=now+15, reminder=5分钟 来凑 10 分钟）
使用原则
- 用户说"帮我添加..."时，用 add action
- 用户问"我今天有什么安排"时，用 today action
- 用户说"把那个取消/完成"时，先 list 找到 record_id，再 update/complete/delete
- 时间格式用 ISO8601: "2026-02-17T15:00:00+08:00"
- 不确定用户意图时，先用 summary 展示概览
- 用户说"我在某地"时，用 set_location 更新位置
🔍 主动识别日程相关意图
💡 系统已自动注入今日日程和待办任务到你的上下文中（<daily-context>）。
当用户提到完成、取消、变更等状态词时，直接对照上下文中的日程/任务操作，无需先查询。
用户不一定会明确说"帮我安排"或"提醒我"。当用户的消息中包含时间信息或事件信息时，主动判断是否需要创建/更新日程：
触发信号（出现任意一个就应该关联到 planner）：
- 时间词：明天、后天、下周、X月X号、X点、周末、今晚
- 事件词：要去、打算、得做、有个、约了、安排了
- 状态词：做了、完成了、已经、搞定了、取消了
行为规则：
| 用户说的话 | Agent 应该做什么 |
|---|
| "明天要去看电影" | 先 today/upcoming 查是否已有该日程。没有则建议创建（"要不要帮你加到日程？几点的？"） |
| "周末得交论文" | 建议创建日程（"要加到日程提醒你吗？"） |
| "那个买票的事已经搞定了" | 先 today/upcoming 查找匹配的日程，找到后标记已完成 |
| "明天的会改到后天了" | 查找明天的会议日程，更新时间 |
| "算了那个不去了" | 结合上下文找到对应日程，标记已取消 |
| "A不做了，改成B" / "A改成B了" | ⚠️ 计划变更：先 today/upcoming 查找旧日程A → 取消或删除旧日程 → 添加新日程B。两步都要做 |
⚠️ 计划变更检测（最易遗漏）：
用户提到新计划时，如果同时暗示旧计划取消（"不吃饭了""不去了""改成"），必须先查已有日程再处理。常见模式：
- "晚上不吃饭了，改成上网" → 查找已有的"吃饭"日程 → 取消 → 添加"上网"
- "明天那个会不开了，改成线上" → 查找会议 → 更新或替换
- "跟同学不去XX了，去YY" → 查找旧日程 → 取消 → 添加新日程
执行顺序：today/upcoming 查已有日程 → 处理旧日程（取消/删除/更新）→ 添加新日程
注意：不要每句话都问用户"要不要加日程"。只在明确包含时间+事件的信息时才触发。闲聊、讨论技术等不触发。
🔍 主动识别位置变更
核心原则：每次回复时，如果你从对话中推断出用户当前所在城市与 daily-context 的 📍 所在地 不同，必须主动处理——不需要用户显式说"帮我更新位置"。依靠你的理解能力判断，不要做关键词匹配。
自检习惯：回复前问自己——"我的回复暗含用户在某个城市吗？这个城市和 📍 所在地 一致吗？不一致 → 处理。"
行为规则：
- 确定用户已在某地（直接声明、或从上下文能确定推断出）→ 直接
set_location，不用问
- 用户提到即将出发但还没走→ 提议更新位置，让用户决定
- 不确定→ 简单问一句"你现在已经在X了吗？要更新位置吗？"
⚠️ category 分类规则（必读）
category 只有 7 个选项：科研、项目、日常、会议、健康、社交、琐事
选 category 的方法：看用户要做什么事，忽略"提醒我""记得"这类措辞。
| 用户说的话 | 事情本身 | category |
|---|
| "提醒我交论文" | 交论文 | 科研 ✅ 进日历 |
| "提醒我回复导师邮件" | 回邮件 | 日常 ✅ 进日历 |
| "提醒我3点开会" | 开会 | 会议 ✅ 进日历 |
| "提醒我下午去健身" | 健身 | 健康 ✅ 进日历 |
| "提醒我5-7点见同学" | 见同学 | 社交 ✅ 进日历 |
| "记得写代码" | 写代码 | 项目 ✅ 进日历 |
| "别忘了明天5点前交报告" | 交报告 | 日常 ✅ 进日历 |
| "出门记得扔垃圾" | 扔垃圾 | 琐事 ❌ 不进日历 |
| "提醒我明天带伞" | 带伞 | 琐事 ❌ 不进日历 |
| "别忘了带钥匙" | 带钥匙 | 琐事 ❌ 不进日历 |
"琐事"只用于顺手小事（扔垃圾、带伞、带钥匙、关窗户、取快递）— 不进日历，只消息提醒。
所有正经事情都用具体分类（科研/项目/日常/会议/健康/社交）— 进日历 + 消息提醒。
系统选择指南
| 用户意图 | 正确工具 | 说明 |
|---|
| "X点提醒我做Y"（做事） | planner_schedule add, 具体 category | 进日历 + 消息提醒 |
| "X时候记得Y"（琐事） | planner_schedule add, category="琐事" | 只消息提醒 |
| "帮我安排会议/日程" | planner_schedule add | |
| "帮我加个待办"（无具体时间） | planner_task add | 不进日历，只在晨报待办段 |
| "明天5点前交报告"（有 DDL） | planner_schedule add, category="日常" | 有具体时间的 deadline 用日程，进日历 |
| "我的目标是..." | planner_goal add | |
| "帮我记下这封信/想法/笔记" | planner_notes write | 存为 markdown 文件 |
| "帮我记住我喜欢/不喜欢..." | memory_store 或 MEMORY.md | 个人偏好 |
| "我现在在成都" | planner_report set_location | |
笔记 vs 记忆 — 区分原则
| 内容类型 | 用什么 | 说明 |
|---|
| 情书、诗、日记、想法、笔记 | planner_notes | 结构化文件，可浏览、搜索、组织 |
| 用户偏好、个人信息、习惯 | memory_store / MEMORY.md | 持久记忆，影响 agent 行为 |
