← 返回 Skills 市场
ironmanc2014

Cn Holiday Reminder

作者 ironmanc2014 · GitHub ↗ · v1.1.0 · MIT-0
cross-platform ✓ 安全检测通过
167
总下载
0
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install cn-holiday-reminder
功能描述
中国法定节假日查询与主动提醒 + 恋爱助手。内置节假日和调休数据,支持查询任意日期是否上班、 下一个假期、全年日历,并可通过 cron 自动提醒。恋爱助手模块支持纪念日倒计时(精确到秒)、 生日提醒、自定义纪念日、浪漫节日提醒(情人节/白色情人节/女神节/520/七夕/圣诞等)。 Use when: 用户说"明天...
使用说明 (SKILL.md)

CN Holiday Reminder — 节假日提醒 + 恋爱助手

两个模块,一个 cron job 搞定:节假日再也不怕忘调休,纪念日再也不怕忘记。


模块一:节假日查询与提醒

使用方法

python \x3Cskill-dir>/scripts/holiday.py --status          # 今日状态
python \x3Cskill-dir>/scripts/holiday.py --check 2026-05-01 # 查某天
python \x3Cskill-dir>/scripts/holiday.py --calendar 2026    # 全年日历
python \x3Cskill-dir>/scripts/holiday.py --next             # 下一个假期
python \x3Cskill-dir>/scripts/holiday.py --alerts 3         # 未来3天提醒
python \x3Cskill-dir>/scripts/holiday.py --json             # JSON输出

数据说明

  • 2025 年:国务院正式数据
  • 2026 年:预测数据(标记 *),国务院公布后更新
  • 内置数据,零 API 依赖

模块二:恋爱助手 💑

首次安装引导

安装 skill 后,Agent 应主动引导用户完成设置:

  1. 询问"要设置恋爱助手吗?可以帮你记住纪念日和生日~"
  2. 运行 love.py --setup 进行交互式设置
  3. 或由 Agent 收集信息后直接写入 ~/agent-memory/love.json

需要收集的信息:

  • 另一半的名字/昵称
  • 在一起的日期(YYYY-MM-DD)
  • 另一半的生日(YYYY-MM-DD)
  • 自定义纪念日(可选,如求婚日、结婚日)
  • 提醒偏好(提前几天、是否每月纪念日提醒)

使用方法

python \x3Cskill-dir>/scripts/love.py --setup              # 交互式设置
python \x3Cskill-dir>/scripts/love.py --status             # 状态总览
python \x3Cskill-dir>/scripts/love.py --together           # 在一起多久(精确到秒)
python \x3Cskill-dir>/scripts/love.py --alerts 7           # 未来7天恋爱提醒
python \x3Cskill-dir>/scripts/love.py --holidays           # 浪漫节日日历
python \x3Cskill-dir>/scripts/love.py --json               # JSON输出

对话查询

用户可以直接问 Agent:

  • "在一起多久了" → 精确到 X年X月X天X小时X分X秒
  • "TA生日还有几天" → 倒计时
  • "下个情人节" → 日期和天数
  • "今年有哪些浪漫节日" → 完整日历

内置浪漫节日

日期 节日 提示
02-14 💝 情人节 准备礼物和浪漫晚餐
03-08 👸 女神节 送她一份惊喜
03-14 🤍 白色情人节 回赠礼物的日子
05-20 💕 520表白日 说出你的爱
七夕 🎋 七夕节 中国情人节
11-11 🛍️ 双十一 一起买买买
12-24 🎄 平安夜 送苹果,许平安
12-25 🎅 圣诞节 交换圣诞礼物

数据存储

数据保存在 ~/agent-memory/love.json,格式:

{
  "partner_name": "小美",
  "anniversary": "2025-06-15",
  "partner_birthday": "1998-03-20",
  "custom_dates": [
    {"name": "求婚日", "date": "2026-02-14", "emoji": "💍"}
  ],
  "reminders": {
    "anniversary": true,
    "birthday": true,
    "love_holidays": true,
    "monthly": false,
    "days_before": 1
  }
}

Agent 可以直接读写此文件,无需每次运行脚本。


Cron 自动提醒

一个 cron job 同时检查节假日和恋爱纪念日:

schedule: { kind: "cron", expr: "0 8 * * *", tz: "Asia/Shanghai" }
payload: {
  kind: "agentTurn",
  message: "检查今天的节假日和恋爱提醒:
    1. 运行 holiday.py --alerts 3
    2. 运行 love.py --alerts 3
    如果有任何提醒就合并后通知用户,没有则不发消息。"
}
sessionTarget: "isolated"
delivery: { mode: "announce", channel: "feishu" }

提醒示例

🔔 调休提醒:明天(周六)需要上班,国庆节调休
💝 还有1天就是情人节!准备礼物和浪漫晚餐
💑 今天是你和小美的恋爱纪念日!在一起 365 天了!
🎂 还有2天就是小美的生日!准备礼物了吗?

故障排查

问题 原因 解决方案
"尚未设置恋爱助手" love.json 不存在 运行 love.py --setup 或让 Agent 引导设置
七夕日期不对 农历日期每年不同 检查脚本中 QIXI_DATES 数据
纪念日计算差一天 时区问题 确认系统时区为 Asia/Shanghai
cron 没同时检查恋爱提醒 cron message 没包含 love.py 更新 cron job 的 message 内容
自定义纪念日不提醒 days_before 设太小 修改 love.json 中 reminders.days_before
编码错误 Windows GBK 脚本已内置 UTF-8 修复
安全使用建议
This skill appears to do what it claims: local holiday queries plus a 'love assistant' that saves anniversaries and birthdays in ~/agent-memory/love.json and can send scheduled reminders. Before installing, consider: (1) Privacy — the skill stores personal data (partner name/birthdates) on disk; if others have access to your account or machine, protect that file. (2) Scheduled notifications — the SKILL.md includes a cron payload that will announce to a channel (feishu); confirm the delivery channel and platform credentials are correct and that you want automated messages. (3) Review and run the included scripts manually first to verify behavior and timezone handling. (4) If you do not want persistent storage, do not allow the agent to write ~/agent-memory/love.json or disable scheduling. Overall the components are coherent and there are no obvious hidden network calls or secret-exfiltration behaviors in the provided code.
功能分析
Type: OpenClaw Skill Name: cn-holiday-reminder Version: 1.1.0 The skill bundle provides legitimate utility for tracking Chinese public holidays and personal anniversaries. The Python scripts (holiday.py and love.py) operate entirely locally without network access, storing user-provided relationship data in a standard local directory (~/agent-memory/love.json). No evidence of data exfiltration, malicious execution, or harmful prompt injection was found.
能力评估
Purpose & Capability
Name/description match the included scripts and SKILL.md: holiday.py implements holiday queries/alerts and love.py implements anniversary/birthday reminders and storage. Required resources (none) are proportionate to the stated purpose.
Instruction Scope
Instructions ask the agent to read/write ~/agent-memory/love.json, run the two local Python scripts, and (optionally) set up a cron job that will cause scheduled announcements. This is expected for a reminder skill, but it does grant the agent the ability to store and reuse private personal data and to send scheduled notifications; users should be aware of that scope.
Install Mechanism
No install spec; skill is instruction + two local Python scripts. No remote downloads or package installs are invoked in SKILL.md or the visible code.
Credentials
The skill declares no required environment variables or credentials and the code does not attempt to access secrets or external services. It does write to a user-local path (~/agent-memory/love.json), which is appropriate for storing reminders but is sensitive in content.
Persistence & Privilege
always is false. The skill expects to persist user data to ~/agent-memory/love.json and suggests a cron-based scheduled announcement (delivery: channel 'feishu'). Autonomous invocation is allowed (platform default). Review scheduling and delivery targets to avoid unwanted automatic notifications.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install cn-holiday-reminder
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /cn-holiday-reminder 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.1.0
**新增恋爱助手模块,支持纪念日和生日提醒** - 新增恋爱助手功能,支持恋爱纪念日倒计时、生日提醒、自定义纪念日、浪漫节日自动提醒。 - 支持与节假日提醒模块一同运行,可合并提醒消息。 - 添加 `scripts/love.py` 脚本,支持恋爱相关的设置与查询。 - 通过 `~/agent-memory/love.json` 保存纪念日、生日与提醒配置。 - 更新文档,详细指导首次引导、数据结构与一体化 cron job 用法。
v1.0.0
CN Holiday v1.0.0 — 初始发布 - 支持查询中国法定节假日、调休与是否上班(内置节假日数据,无需外部 API) - 可查看全年节假日与调休日历,支持节假日预测 - 支持查询任意日期的工作/休假状态及下一个假期 - 提供 cron 自动提醒功能,可主动推送调休、假期预告 - 可输出 JSON 结果,便于集成自动化 Agent
元数据
Slug cn-holiday-reminder
版本 1.1.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 2
常见问题

Cn Holiday Reminder 是什么?

中国法定节假日查询与主动提醒 + 恋爱助手。内置节假日和调休数据,支持查询任意日期是否上班、 下一个假期、全年日历,并可通过 cron 自动提醒。恋爱助手模块支持纪念日倒计时(精确到秒)、 生日提醒、自定义纪念日、浪漫节日提醒(情人节/白色情人节/女神节/520/七夕/圣诞等)。 Use when: 用户说"明天... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 167 次。

如何安装 Cn Holiday Reminder?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install cn-holiday-reminder」即可一键安装,无需额外配置。

Cn Holiday Reminder 是免费的吗?

是的,Cn Holiday Reminder 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Cn Holiday Reminder 支持哪些平台?

Cn Holiday Reminder 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Cn Holiday Reminder?

由 ironmanc2014(@ironmanc2014)开发并维护,当前版本 v1.1.0。

💬 留言讨论