效果预览

!schedule-feishu 日程文档效果预览 技能安装后自动在飞书生成结构化日程文档，按日期分组展示所有待办/已完成事项，自动跟踪行程进度，到期前30分钟触发提醒，超出保留天数的历史日程自动清理。

功能说明

通用飞书日程管理工具，安装后自动为当前飞书用户创建专属日程文档，支持日程新增、状态跟踪、智能提醒全流程管理。

安装配置

• 前置依赖：必须先安装 feishu-doc 技能并完成飞书应用授权，拥有文档读写权限
• 安装时支持自定义最大日程保留天数，不配置则使用默认值7天，最多保留7天的日程数据
• 安装后会自动执行初始化流程，在用户飞书根目录创建「个人日程安排」文档，自动生成标准结构

配置文件（自动生成）

所有配置项保存在技能目录下的config.json文件中，无需硬编码到其他文件：

{
  "schedule_doc_url": "飞书文档完整URL",
  "doc_token": "飞书文档token",
  "max_retention_days": 7, // 最大保留天数，默认7
  "chatId": "ou_xxxxxxxxxxxxxxxx" // 飞书用户ID，从飞书对话中自动获取
}

chatId获取方式

技能会自动从飞书消息上下文中提取用户ID：

• 首次使用：当用户在飞书中与机器人对话时，自动提取ID并保存到config.json
• 无需手动配置：技能会自动处理，用户无需手动获取或配置
• 自动更新：如果检测到不同的ID，会自动更新配置

文档结构（固定）

结构规则

• 以日期作为每个日程块的标题，格式：## 📅 YYYY-MM-DD 周X
• 最新日期的日程块始终展示在文档最顶部
• 每天的日程对应单独的表格

单天表格表头结构

| ✅ 状态 | 🕒 时间 | 📝 事项内容 | 📌 备注 | 状态列固定在第一列，不可修改顺序。

状态枚举

• ⏳ 未开始：待执行的行程
• ✅ 已完成：已经完成的行程
• ❌ 已取消：取消的行程
• ⚠️ 进行中：正在进行的行程

使用流程

阶段1：安装技能

• 从ClawHub安装 schedule-feishu 技能
• 系统自动检测前置依赖（feishu-doc技能）
• 自动执行初始化流程，创建飞书日程文档
• 生成配置文件 config.json

阶段2：用户首次使用

• 用户在飞书中与机器人对话（发送日程相关请求）
• 技能自动从消息上下文中提取用户ID
• 自动保存到 config.json 文件
• 发送确认消息："✅ 已自动配置你的飞书ID，现在可以接收日程提醒了！"

阶段3：日常使用

• 用户通过自然语言添加日程："明天上午10点开会"
• 技能解析日期时间，自动记录到飞书文档
• 更新日程后发送链接地址：每次添加或更新日程后，必须向用户发送日程文档的完整URL
• 心跳检查时自动发送提醒（即将开始、超时）
• 所有通知自动发送到用户飞书私聊

心跳检查

将下面的检查清单追加到HEARTBETA.md文件中：

• 读取当前飞书日程文档所有待办事项，检查即将开始和超时未完成的行程，自动发送提醒到用户飞书会话，文档地址读取配置文件(skills/schedule-feishu/config.json)。
• 每日6点删除超出最大保留天数的最早日程数据，最大保留天数和日程文档地址读取配置文件。

配置来源：

• 文档地址：从 skills/schedule-feishu/config.json 读取
• 最大保留天数：从同一配置文件读取
• chatId：自动从消息上下文提取

提醒触发条件：

• 即将开始：行程开始前30分钟
• 超时未完成：超过预定时间且状态为"⏳ 待完成"

通知与提醒

提醒触发条件

• 即将开始提醒：行程开始前30分钟
• 超时提醒：超过预定时间仍未完成
• 每日检查：每30分钟执行一次心跳检查

提醒消息格式

🦞 日程提醒
📅 即将开始：
去公司开会（10:00后30分钟）
⚠️ 超时未完成：
去健身房（原定09:00，已超时1小时）

日程更新反馈

文档链接发送规则

重要： 每次添加或更新日程后，必须向用户发送日程文档的完整URL

实现要点：

• 在完成日程写入操作后，从 config.json 读取 schedule_doc_url
• 将文档URL包含在确认消息中
• 格式示例：🦞 已记录：明天上午9点去跑步\n\n📋 日程文档：https://feishu.cn/docx/xxxxx

用户价值：

• 方便用户随时查看完整日程
• 快速访问历史记录
• 分享日程给他人

自动清理

清理规则

• 每日执行：每天早上6点执行清理
• 保留天数：由配置文件中的 max_retention_days 控制（默认7天）
• 清理范围：删除超出保留天数的历史日期数据
• 保留内容：保留当天和未来的所有数据

错误处理

常见错误

• 飞书文档未创建：自动执行初始化流程
• chatId未配置：从消息上下文自动提取
• 配置文件缺失：自动创建默认配置
• 飞书API调用失败：记录错误日志，提示用户检查权限

依赖工具

• feishu_doc：飞书文档读写操作
• message：发送飞书提醒消息
• config：读取和更新配置文件
• heartbeat：定时检查和清理