Design & media

alarm

Try it

读取飞书/lark 的文本或语音消息，识别是否包含需要提醒的待办和截止时间，并根据消息语义和时间跨度自动判断一个偏宽松的提醒时间。适用于飞书机器人处理“今天 5 点前给我”“明天下午三点提醒我”“发语音说周五前记得提交”这类消息。支持先用 senseaudio asr 把语音转文字，再分析并建立提醒；启用 asr...

What it does

读取飞书/lark 的文本或语音消息，识别是否包含需要提醒的待办和截止时间，并根据消息语义和时间跨度自动判断一个偏宽松的提醒时间。适用于飞书机器人处理“今天 5 点前给我”“明天下午三点提醒我”“发语音说周五前记得提交”这类消息。支持先用 senseaudio asr 把语音转文字，再分析并建立提醒；启用 asr...

The skill document

Feishu Smart Alarm

概述

这个 Skill 用于在飞书消息中自动识别“需要在某个时间前提醒”的内容，并完成四类动作：

  1. 读取文本消息并判断是否需要建立提醒
  2. 读取语音消息，先调用 SenseAudio ASR 转写，再判断是否需要建立提醒
  3. 解析截止时间，并计算由系统根据消息语义和时间跨度自动判断，更偏宽松一点的预留时间 的提醒时间
  4. 立即在原会话发送确认消息：我已经记住并在$时间点$提醒
  5. 到点后仅提醒一次，并把提醒发回原飞书会话

默认约定：

  • 支持飞书文本消息和语音消息
  • 语音消息必须先落到本地文件，再把本地路径传给脚本
  • 默认提醒对象是原消息发送者
  • 默认把提醒消息发回原飞书会话
  • 每条提醒只发送一次
  • 默认时区：Asia/Shanghai

适用消息

优先识别以下类型：

  • 今天 5 点前给我
  • 明天下午三点提醒我开会
  • 周五前记得把这个提交
  • 今晚 8 点前把材料发我
  • 后天上午记得找我确认
  • 下周一 10 点别忘了评审
  • 语音里说：周五前提醒我把材料发出去
  • 语音里说：明天下午三点提醒我开会

不建立提醒的情况

以下情况默认不建提醒：

  • 纯闲聊，没有任务或截止语义
  • 没有可解析时间
  • 明显是历史回顾而非未来待办
  • 时间解析结果早于当前时间且无法合理滚动到未来
  • 语音转写成功，但转写文本不包含提醒/待办语义

时间解析规则

脚本支持以下常见时间表达：

  • 绝对时间：2026-03-20 15:00、2026/3/20 15:00
  • 月日时间：3月20日 15:00、3月20号下午3点
  • 相对日期：今天、明天、后天
  • 周几：周一、周五、下周二
  • 时段：上午、中午、下午、晚上、凌晨
  • 纯时间：5点、5:30、下午三点

默认补全策略：

  • 仅有日期但无具体时间：默认 18:00
  • 仅有“上午 / 下午 / 晚上”无具体小时：分别默认 10:00 / 15:00 / 20:00
  • 仅有纯时间且今日该时刻已过：顺延到明天

消息分析规则

建立提醒必须同时满足：

  1. 能解析出未来时间
  2. 消息里存在待办/提醒/截止语义中的至少一种

强触发关键词示例：

  • 提醒
  • 记得
  • 别忘
  • 截止
  • 前给我
  • 前发我
  • 前提交
  • 要做
  • 要交
  • 开会
  • 评审
  • 确认
  • 安排

如果消息虽然没有“提醒”字样，但具有明显的“任务 + 时间”结构，也可以建立提醒。

确认消息规则

一旦建立提醒，必须立刻在原会话发送确认消息：

我已经记住并在$时间点$提醒

其中 $时间点$ 填入提醒时间，不是截止时间。例如：

  • 今天 17:00 前给我 → 可能提醒在 16:20 或 15:30，取决于任务紧急程度
  • 下周一开会别忘了 → 可能更早预留数小时甚至前一天提醒
  • 确认消息会使用系统自动判断出来的提醒时间

到点提醒规则

到达提醒时间后，发送一次提醒消息到原飞书会话。

建议提醒模板：

  • 私聊：提醒你：{summary}（截止时间 {deadline_text}）
  • 群聊：提醒 {sender_name}：{summary}（截止时间 {deadline_text}）

发送成功后，将提醒状态标记为已发送，不再重复提醒。

环境变量（硬性要求）

当前版本硬性要求以下环境变量由运行时注入：

FEISHU_APP_ID=...
FEISHU_APP_SECRET=...
SENSEAUDIO_API_KEY=...

可选项：

FEISHU_BASE_URL=https://open.feishu.cn
FEISHU_SMART_ALARM_DB=./data/reminders.db
FEISHU_SMART_ALARM_TZ=Asia/Shanghai
SENSEAUDIO_BASE_URL=https://api.senseaudio.cn
SENSEAUDIO_ASR_MODEL=sense-asr

强约束：

  1. 不读取 .env、.env.local 或其他本地配置文件
  2. 不在交互式终端里临时询问 API Key
  3. 缺少 SENSEAUDIO_API_KEY 时，所有音频相关入口必须直接失败
  4. 缺少 FEISHU_APP_ID / FEISHU_APP_SECRET 时，所有发送确认或发送提醒的入口必须直接失败

脚本入口

1. 分析文本消息

python scripts/main.py analyze-message --text "今天 5 点前给我"

2. 先转写语音，再只做分析

python scripts/main.py analyze-audio --audio /abs/path/input.m4a --sender-name 张三

返回：

  • 语音转写结果 transcript
  • 是否需要提醒
  • 解析到的截止时间
  • 提醒时间
  • 确认消息

3. 只做 ASR 转写

python scripts/main.py transcribe-audio --audio /abs/path/input.m4a

4. 根据文本建立提醒并立即回确认

python scripts/main.py create-reminder \
  --text "今天 5 点前给我" \
  --receive-id oc_xxx \
  --receive-id-type chat_id \
  --sender-open-id ou_xxx \
  --sender-name 张三

5. 根据语音建立提醒并立即回确认

python scripts/main.py create-reminder-audio \
  --audio /abs/path/input.m4a \
  --receive-id oc_xxx \
  --receive-id-type chat_id \
  --sender-open-id ou_xxx \
  --sender-name 张三

这个命令会：

  • 先用 SenseAudio ASR 转写语音
  • 按转写结果判断是否需要提醒
  • 如有提醒需求则存入本地 SQLite
  • 立刻向原会话发送确认消息

6. 轮询并发送到期提醒

python scripts/main.py poll-due

7. 以常驻循环方式运行

python scripts/main.py run-loop --interval 30

表示每 30 秒检查一次是否有到期提醒。

与 PicoClaw 的接法

推荐在飞书消息进入后这样使用：

文本消息

  1. 对文本消息调用 create-reminder
  2. 如果返回 need_reminder=false，继续普通聊天逻辑
  3. 如果返回 need_reminder=true：
    • 确认消息已发出
    • 后台由 run-loop 常驻检查并在到点时发送提醒

语音消息

  1. 先把飞书语音下载到本地临时文件
  2. 对本地文件调用 create-reminder-audio
  3. 如果返回 need_reminder=false，继续普通聊天逻辑
  4. 如果返回 need_reminder=true：
    • 确认消息已发出
    • 后台由 run-loop 常驻检查并在到点时发送提醒

更详细的接法见：

  • references/integration_cn.md
  • references/time_rules_cn.md

Related skills

Feishu Smart Alarm

读取飞书/Lark 消息文本，识别是否包含需要提醒的待办和截止时间，并在由系统根据消息语义和时间跨度自动判断，更偏宽松一点的预留时间发出一次提醒。适用于飞书机器人在私聊或群聊中处理诸如“今天 5 点前给我”“明天下午三点提醒我”“周五前记得提交”这类消息；默认提醒给原消息发送者，并将提醒发回原飞书会话。识别成功后...

18 installs

飞书日历基础版

管理飞书(Lark)日历,支持列出日历、搜索日程、检查安排与同步事件。Use when 需要SEO优化、关键词分析、排名提升、搜索流量优化时使用。不适用于黑帽SEO手段。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互，无需复杂配置即开即用。输出结果可直接使用，减少二次加工成本。提供结构化输出和错误处理机制。

1 installs

lark-contact

飞书 / Lark 通讯录,用于按姓名 / 邮箱把员工解析成 open_id,以及按 open_id 反查员工的姓名 / 部门 / 邮箱 / 联系方式。当用户说出某人姓名而下一步需要发消息 / 加群 / 排日程时,先用本 skill 把姓名换成 ID;当输出里出现 open_id 需要展示成姓名给用户看,或用户直...

4 installs

飞书自动化工具

每天在飞书上重复操作太浪费时间？消息定时推送、日报自动生成、多维表格批量操作、审批流程配置——一个技能把这些飞书日常全部自动化，支持Cron定时，设好就不用管了。 触发词：飞书自动化、飞书消息推送、飞书多维表格、飞书日报、飞书审批、飞书日历、lark自动化 排除：飞书开发(用lark_cli)、飞书机器人创建、非...

8 installs

calendar-sync-tool

Manage Feishu (Lark) calendars by listing, searching, checking schedules, syncing events, and mar。Use when 用户需要calendar-sync-tool相关功能时使用。不适用于超出本技能能力范围的复杂需求。

1 installs

calendar-reminder-free

面向个人开发者的 Outlook 日历提醒 Skill 免费版。每晚 22:00 扫描明日 Outlook 日历, 将上午日程与下午日程分别按"提前 2 小时"和"当天 12:00 统一"两种基础策略推送飞书提醒. 基于 owa-outlook skill 提供的 owa_calendar.py 读取日历数据,通过 skill-platform CLI 注册 cron. 适用于个人每日日程前置提醒的基础场景。高级特性(跨时区处理、团队群共享、安静时段、 多渠道通知)请升级付费版.