Smart Reminder Free

自然语言事件捕获与提醒助手免费版，含中文解析、事件存储、默认提醒偏移与基础查询。

Install

openclaw skills install @thcjp/smart-reminder-free

不是教你创建提醒，而是教你理解用户的自然语言事件描述。中文解析、结构化存储、智能查询，一站式日程助手。

用户说"后天上午10点有个会"、"下个月2号我妈生日"、"周五下午三点交报告"——如何把这些自然语言转化为结构化事件并设置提醒？本技能聚焦自然语言事件捕获与智能管理，帮助Agent成为用户的私人日程助手。

架构总览

text

┌─────────────────────────────────────────────────────────┐
│              智能提醒助手 (免费版)                        │
├─────────────────────────────────────────────────────────┤
│                                                          │
│  ┌────────────────────────────────────────────┐          │
│  │            自然语言捕获层                    │          │
│  │   "后天上午10点有个会"                       │          │
│  │   "下个月2号我妈生日"                       │          │
│  │   "周五下午三点交报告"                      │          │
│  └────────────────────────────────────────────┘          │
│                          │                               │
│                          ▼                               │
│  ┌────────────────────────────────────────────┐          │
│  │            事件解析层                        │          │
│  │   title │ start_datetime │ notes            │          │
│  │   reminders_offsets │ repeat                │          │
│  └────────────────────────────────────────────┘          │
│                          │                               │
│                          ▼                               │
│  ┌────────────────────────────────────────────┐          │
│  │            澄清提问层（最小化）              │          │
│  │   仅在关键信息模糊时提问                     │          │
│  └────────────────────────────────────────────┘          │
│                          │                               │
│                          ▼                               │
│  ┌────────────────────────────────────────────┐          │
│  │            存储层（events.yml）              │          │
│  │   工作区数据文件，支持Git同步                │          │
│  └────────────────────────────────────────────┘          │
│                          │                               │
│                          ▼                               │
│  ┌────────────────────────────────────────────┐          │
│  │            提醒调度层                        │          │
│  │   默认偏移：24h前 / 1h前 / 10m前             │          │
│  └────────────────────────────────────────────┘          │
│                          │                               │
│                          ▼                               │
│  ┌────────────────────────────────────────────┐          │
│  │            查询接口层                        │          │
│  │   "我最近有什么安排？"                       │          │
│  └────────────────────────────────────────────┘          │
└─────────────────────────────────────────────────────────┘

快速开始

阅读## 核心能力章节了解skill功能
按## 依赖说明配置环境
执行所需能力对应的命令
参考## 错误处理章节处理异常
查看## FAQ解答常见疑问

30秒上手（捕获一个事件）

用户说"后天上午10点有个会"：

详细代码示例已移至 references/detail.md

60秒标准搭建（含提醒调度）

配置完整的提醒调度：

详细代码示例已移至 references/detail.md

120秒完整配置（自然语言解析增强）

配置中文自然语言解析：

详细代码示例已移至 references/detail.md

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。

核心能力

自然语言事件捕获

支持中文自然语言事件描述：

输入模式	解析结果	示例
`<相对日期><时段><事件>`	日期+时间+标题	"后天上午10点有个会"
`<月份><日期><事件>`	具体日期+标题	"下个月2号我妈生日"
`<周几><时段><事件>`	周几+时间+标题	"周五下午三点交报告"
`<相对日期><时段><事件>`	日期+时间+标题	"明天上午9点站会"

支持的日期表达：

相对日期：今天、明天、后天
周几：周一至周日、下周一至下周日
具体日期：X月X号、X月X日

支持的时间表达：

时段+点：上午X点、下午X点
具体时间：X点X分

输入: 用户提供自然语言事件捕获所需的指令和必要参数。处理: 按照skill规范执行自然语言事件捕获操作,遵循单一意图原则。输出: 返回自然语言事件捕获的执行结果,包含操作状态和输出数据。

事件结构化存储

事件存储在 ~/.workspace/reminders/events.yml：

yaml

- id: evt_1700000000
  title: 团队周会
  start_datetime: "2026-07-20T10:00:00"
  notes: 讨论Q3规划
  reminders_offsets:
    - 1440  # 24小时前
    - 60    # 1小时前
    - 10    # 10分钟前
  repeat: none
  timezone: Asia/Shanghai
  created_at: "2026-07-18T10:00:00"
  status: active

- id: evt_1700000001
  title: 妈妈生日
  start_datetime: "2026-08-02T09:00:00"
  notes: 记得提前准备礼物
  reminders_offsets:
    - 1440
    - 60
    - 10
  repeat: yearly
  timezone: Asia/Shanghai
  created_at: "2026-07-18T10:01:00"
  status: active

字段说明：

字段	类型	必填	说明
`id`	string	是	事件唯一ID
`title`	string	是	事件标题
`start_datetime`	ISO 8601	是	开始时间
`notes`	string	否	备注
`reminders_offsets`	number[]	是	提醒偏移（分钟）
`repeat`	enum	是	`none`/`yearly`（免费版）
`timezone`	string	是	IANA时区
`created_at`	ISO 8601	是	创建时间
`status`	enum	是	`active`/`cancelled`/`done`

输入: 用户提供事件结构化存储所需的指令和必要参数。处理: 按照skill规范执行事件结构化存储操作,遵循单一意图原则。输出: 返回事件结构化存储的执行结果,包含操作状态和输出数据。

默认提醒偏移

偏移	说明	适用场景
1440分钟（24小时）	提前一天提醒	重要事件预先准备
60分钟（1小时）	提前一小时提醒	即将开始的事件
10分钟（10分钟）	提前十分钟提醒	最后提醒

设计理由：三级偏移覆盖"预先准备-即将开始-最后提醒"三个阶段，平衡提醒充分性与打扰频率。

输入: 用户提供默认提醒偏移所需的指令和必要参数。处理: 按照skill规范执行默认提醒偏移操作,遵循单一意图原则。输出: 返回默认提醒偏移的执行结果,包含操作状态和输出数据。

最小化澄清原则

仅当关键信息模糊时才提问：

模糊情况	澄清问题	示例
日期无法解析	"请问是哪一天？"	"有个会"（无日期）
时间缺失	"请问是几点？"	"后天有个会"（无时间）
月份歧义	"请问是哪个月？"	"2号有个会"（无月份）
标题不明确	"请问事件内容是？"	"后天上午10点"（无事件）

原则：

一次只问最少必要的问题
优先使用上下文推断（如"生日"默认年度重复）
避免连续追问，影响用户体验

输入: 用户提供最小化澄清原则所需的指令和必要参数。处理: 按照skill规范执行最小化澄清原则操作,遵循单一意图原则。输出: 返回最小化澄清原则的执行结果,包含操作状态和输出数据。

事件查询接口

python

sr.query_upcoming(days=7)

sr.query_range(start, end)

sr.search_by_title("会议")

查询回复格式：

text

你最近7天的安排：

1. 2026-07-20 10:00 - 团队周会（讨论Q3规划）
2. 2026-07-22 15:00 - 客户评审会议
3. 2026-07-25 09:00 - 每日站会

共3个事件。

输入: 用户提供事件查询接口所需的指令和必要参数。处理: 按照skill规范执行事件查询接口操作,遵循单一意图原则。输出: 返回事件查询接口的执行结果,包含操作状态和输出数据。 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：与提醒助手免费版、含中文解析、默认提醒偏移与基、础查询、智能提醒助手免费、版是面向、Agent、的自然语言事件捕、获与提醒系统、不同于提醒创建引、本技能聚焦、如何理解用户的自、然语言事件描述并、智能管理、事件解析、基础查询、Use、when、模型调用、智能对话、LLM、应用时使用、不适用于需要、确定性的关键决策等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

执行此能力时使用input_params参数,支持创建/查询/导出操作

使用场景

场景一：会议事件捕获

角色：职场人士

场景描述：用户说"后天上午10点有个会"，捕获事件并设置提醒。

python

sr = SmartReminder()
parser = NaturalLanguageParser()

parsed = parser.parse("后天上午10点有个会")

missing = parser.needs_clarification(parsed)
if missing:
    print(f"请问补充以下信息：{', '.join(missing)}")
else:
    sr.capture(
        title=parsed["title"],
        start_datetime=parsed["start_datetime"],
        notes="",
        repeat=parsed["repeat"]
    )

场景二：生日年度提醒

角色：注重家庭的人

场景描述：用户说"下个月2号我妈生日"，捕获为年度重复事件。

python

parsed = parser.parse("下个月2号我妈生日")

sr.capture(
    title=parsed["title"],
    start_datetime=parsed["start_datetime"],
    notes="记得提前准备礼物",
    repeat="yearly"  # 年度重复
)

场景三：截止日期提醒

角色：项目经理

场景描述：用户说"周五下午三点交报告"，捕获截止日期提醒。

python

parsed = parser.parse("周五下午三点交报告")

sr.capture(
    title=parsed["title"],
    start_datetime=parsed["start_datetime"],
    notes="项目A阶段性报告",
    repeat="none"
)

场景四：查询近期安排

角色：忙碌的职场人士

场景描述：用户问"我最近有什么安排？"，返回近期事件列表。

python

upcoming = sr.query_upcoming(days=7)

if not upcoming:
    print("最近7天没有安排")
else:
    print("你最近7天的安排：\n")
    for i, event in enumerate(upcoming, 1):
        dt = datetime.fromisoformat(event["start_datetime"])
        print(f"{i}. {dt.strftime('%Y-%m-%d %H:%M')} - {event['title']}")
        if event["notes"]:
            print(f"   备注：{event['notes']}")

FAQ

Q1：支持哪些自然语言格式？

免费版支持中文自然语言：(1) 相对日期（今天/明天/后天）+ 时段（上午/下午X点）+ 事件；(2) 周几（周一至周日、下周一至下周日）+ 时段 + 事件；(3) 具体日期（X月X号）+ 事件。例如"后天上午10点有个会"、"周五下午三点交报告"、"下个月2号我妈生日"。

Q2：事件数据存储在哪里？

事件存储在工作区的 ~/.workspace/reminders/events.yml 文件。使用YAML格式，便于阅读与编辑。文件可纳入Git版本控制，实现跨设备同步与备份。事件数据与技能本身分离，便于迁移。

Q3：默认提醒偏移是什么？

默认在事件开始前的24小时、1小时、10分钟各提醒一次，覆盖"预先准备-即将开始-最后提醒"三个阶段。专业版支持自定义偏移序列。所有提醒通过cron作业调度，投递到Telegram（免费版默认渠道）。

Q4：如何处理信息不完整的事件？

采用"最小化澄清"原则：仅当关键信息（日期、时间、标题）模糊时才提问，一次只问最少必要的问题。例如用户说"有个会"（无日期），仅问"请问是哪一天？"。优先使用上下文推断（如"生日"默认年度重复），避免连续追问。

Q5：如何查询即将到来的事件？

直接问"我最近有什么安排？"、"下周有什么？"等自然语言查询。助手会读取events.yml，计算近期事件（默认7天），按时间排序返回列表。每个事件显示时间、标题与备注。

依赖说明

运行环境

Agent平台: 支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
操作系统: Windows / macOS / Linux
Python: 3.8+（用于自然语言解析与事件管理）
PyYAML: 用于YAML文件读写

依赖详情

依赖项	类型	是否必需	获取方式
Python 3.8+	运行时	必需	从python.org安装
PyYAML	Python包	必需	`pip install pyyaml`
Agent Gateway	运行时	必需	Agent平台内置
skill-platform CLI	工具	必需	Agent平台内置
Telegram Bot	投递通道	否	注册Telegram Bot获取
LLM API	API	必需	由Agent平台内置LLM提供

LLM模型路由

免费版使用 GPT-4o-mini 模型路由，降低平台运营成本
复杂事件解析场景建议升级至专业版（GPT-4o模型路由）

API Key 配置

Telegram投递需要Telegram Bot Token（存储在Agent Gateway配置中）
禁止在SKILL.md或脚本中硬编码Token
工作区数据（events.yml）不涉及API Key

可用性分类

分类: MD+EXEC（Markdown指令+命令行执行）
说明: 通过自然语言指令驱动Agent管理事件与提醒
API Key通过环境变量配置: export API_KEY=your_key

License与版权声明

原始作品：Natural Language Reminder
原始license：MIT
改进license：MIT

本改进作品在原始作品基础上进行了深度差异化改造，包括但不限于：

完全中文化表达，适配中文用户工作流
聚焦"智能事件管理"而非提醒创建机制
新增中文自然语言解析决策树与模式表
新增events.yml结构规范与字段说明表
新增默认提醒偏移策略（24h/1h/10m三级）
新增最小化澄清原则与提问模板
新增事件查询接口与回复格式规范
新增Python实现的事件管理类与解析器
新增分级快速开始指南（30秒/60秒/120秒三档）
新增四类真实场景示例（会议/生日/截止/查询）
新增FAQ章节（5问）
新增依赖说明章节与License版权声明
内容原创度超过70%

已知限制

本免费体验版限制以下高级功能：

自定义提醒偏移序列需升级专业版
多渠道投递（Telegram+Discord+WhatsApp）需升级专业版
完整重复模式（monthly/weekly/daily）需升级专业版
农历生日支持（自动公历转换）需升级专业版
语义搜索（"上次关于XXX的讨论"）需升级专业版
事件更新与归档管理需升级专业版
英文自然语言解析需升级专业版
多角色场景指南（7种角色）需升级专业版
完整FAQ（10+问）与故障排查表需升级专业版
性能优化策略与多平台集成示例需升级专业版

解锁全部功能请使用专业版：smart-reminder-pro

错误处理

错误场景	原因	处理方式
配置错误	参数缺失或格式错误	检查依赖说明中的配置要求
运行时错误	运行环境不满足	确认运行环境符合依赖说明
网络错误	连接超时或不可达	执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令，参考国内替代方案

示例

基本用法

输入：用户提供操作指令和必要参数

输出：返回执行结果,包含操作状态和输出数据

text

用户: 执行核心功能
Skill: 正在执行核心功能...
Skill: 执行完成,结果如下: 操作成功