功能描述

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

使用说明 (SKILL.md)

Feishu Smart Alarm

Name: feishu-smart-alarm
Author: hei-maom

概述

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

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

提醒时间不再固定为 30 分钟前，而是根据消息语义、时间跨度、是否包含“重要/务必/开会/评审”等关键词，以及是否显式写了“提前多久提醒”来自动判断。整体策略偏保守，会给事情留出稍微宽松一点的预留时间。

默认约定：

只读取飞书消息文本
支持较宽松的中文时间表达
默认提醒对象是原消息发送者
默认把提醒消息发回原飞书会话
每条提醒只发送一次
默认时区：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
仅有纯时间且今日该时刻已过：顺延到明天

消息分析规则

建立提醒必须同时满足：

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

强触发关键词示例：

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

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

确认消息规则

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

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

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

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

到点提醒规则

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

建议提醒模板：

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

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

脚本入口

1. 分析消息

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

返回：

是否需要提醒
解析到的截止时间
提醒时间
确认消息

2. 创建提醒并立即回确认

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

这个命令会：

分析消息
如有提醒需求则存入本地 SQLite
立刻向原会话发送确认消息

3. 轮询并发送到期提醒

python scripts/main.py poll-due

4. 以常驻循环方式运行

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

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

环境变量

默认只要求：

FEISHU_APP_ID=...
FEISHU_APP_SECRET=...

可选项：

FEISHU_BASE_URL=https://open.feishu.cn
FEISHU_SMART_ALARM_DB=./data/reminders.db
FEISHU_SMART_ALARM_TZ=Asia/Shanghai

与 PicoClaw 的接法

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

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

更详细的接法见：

references/integration_cn.md
references/time_rules_cn.md

安全使用建议

This skill appears to implement exactly what it claims: parsing Chinese time expressions, storing reminders locally, and using Feishu credentials to send messages. Before installing, consider: 1) Provide a dedicated Feishu app account with minimal permissions (only what’s needed to send messages) and avoid reusing high-privilege credentials. 2) Run the skill in an isolated environment or container so its automatic .env loading cannot pick up unrelated secrets from the host. 3) Ensure FEISHU_BASE_URL is not overridden to an untrusted endpoint; the default is https://open.feishu.cn. 4) Secure or relocate the SQLite DB path (FEISHU_SMART_ALARM_DB) if the reminders contain sensitive content. 5) Review the code (time parsing, API calls, and the polling loop) yourself if you have additional trust requirements. If you cannot review code, restrict credentials and run under least privilege.

功能分析

Type: OpenClaw Skill Name: feishu-smart-alarm Version: 1.0.0 The skill is a legitimate Feishu/Lark reminder bot that parses Chinese time expressions from messages to schedule notifications. It uses a local SQLite database (reminders.db) for storage and interacts with the official Feishu API for message delivery. The code (main.py, feishu_api.py, time_parser.py) follows standard practices, uses parameterized SQL queries, and lacks any indicators of data exfiltration, malicious execution, or prompt injection attacks.

能力评估

✓ Purpose & Capability

The name/description match the implementation: the code parses Chinese time expressions, decides reminder lead time, stores reminders in a local SQLite DB, and calls the Feishu API to send confirmation and reminder messages. Required env vars (FEISHU_APP_ID, FEISHU_APP_SECRET) are appropriate for this purpose.

ℹ Instruction Scope

SKILL.md and CLI commands limit behavior to analyzing message text, creating local reminders, sending confirmations, and polling/sending due reminders. The code does load .env files (cwd and repo root) into os.environ at runtime — this means any .env placed beside the skill could influence behavior (e.g., override FEISHU_BASE_URL or supply other envs). Otherwise the instructions do not direct reading unrelated system files or exfiltrating data to unexpected endpoints.

✓ Install Mechanism

There is no install spec; the package is run as Python scripts. requirements.txt only lists requests>=2.31.0, which is proportionate. No remote downloads or extracted archives are specified.

ℹ Credentials

The declared required credentials are FEISHU_APP_ID and FEISHU_APP_SECRET — appropriate and minimal for sending messages via Feishu. Optional FEISHU_BASE_URL can override the API host; if set maliciously it could receive tokens (this is a general risk whenever base URLs are overridable). The code also reads .env files automatically, which could surface other secrets if run in a directory with unexpected .env files.

✓ Persistence & Privilege

The skill does not request always:true and does not alter other skills. It persists data to a local SQLite DB and offers a long-running polling loop to send reminders — this is expected for this functionality and within scope.

版本历史

v1.0.0

feishu-smart-alarm 1.0.0 - 首发版本：自动识别飞书消息中的待办和截止时间，生成宽松预留时间的一次性提醒。 - 根据消息语义、时长、关键词等智能判断提醒时间，不再固定提前 30 分钟。 - 内置支持各种中文时间表达与常见触发语句，默认提醒原消息发送者并回复原会话。 - 分析、建立提醒、回发确认、到点后单次提醒全流程支持。 - 支持本地 SQLite 储存提醒，命令行操作一体化。

元数据

Slug feishu-smart-alarm

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题