ClawHub

纪念日管理

v1.0.0

私人日期管家。**重要：所有日期计算（包括相差天数、下周一、月末等）必须使用 calc 命令，不要自己计算，避免出错。** 支持公历和农历计算，提供提醒和情感化文案。触发场景：(1)用户提到生日、纪念日、忌日、祭祖、清明等关键词 (2)用户说"记录XXX的生日"、"记一下XXX" (3)用户问"今天有什么日子"、...

⭐ 0· 71·0 current·0 all-time
by@chanvging

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for chanvging/date-manager.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "纪念日管理" (chanvging/date-manager) from ClawHub.
Skill page: https://clawhub.ai/chanvging/date-manager
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install date-manager

ClawHub CLI

Package manager switcher

npx clawhub@latest install date-manager
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
medium confidence
✓
Purpose & Capability
The name/description (date manager) matches the included CLI script and SKILL.md: commands for add/list/get/today/convert/calc/term etc. Required resources (none) are proportional to a local CLI tool. There are no unrelated credentials, binaries, or config paths requested.
✓
Instruction Scope
SKILL.md instructs the agent to run the included Python script under {SKILL_DIR}/scripts/date_manager.py for all operations and mandates using the script's calc command for date math. The instructions operate on a local data file ({SKILL_DIR}/data/dates.json) and do not instruct the agent to read unrelated system files or external endpoints.
✓
Install Mechanism
No install spec is provided (instruction-only skill with an included script). This minimizes disk footprint beyond the provided files. The script may import optional Python libraries (e.g., chinese_calendar, zhdate) but falls back to local data if unavailable — no remote downloads or external installers are declared.
✓
Credentials
The skill declares no required environment variables, no credentials, and no protected config paths. The internal code references only local file storage for dates.json and optional third-party Python libraries; asked-for environment access is proportionate to the stated purpose.
✓
Persistence & Privilege
always is false and the skill does not request persistent platform privileges. It stores user data only in a local data/dates.json under SKILL_DIR (expected for this type of tool). There is no evidence it modifies other skills or system-wide agent config.
Assessment
This skill is internally consistent: it runs a local Python CLI and stores data under {SKILL_DIR}/data/dates.json, asks for no secrets, and its instructions match its purpose. Before installing, you may want to: (1) review the remainder of scripts/date_manager.py to confirm there are no network calls or unexpected subprocess usage (the file imports subprocess but that alone is not malicious), (2) ensure Python and any optional libraries will be installed in a controlled environment, (3) back up any existing data you keep in the same path, and (4) run the script in a sandbox or restricted environment if you want to test behavior safely. If you want, I can scan the remaining/truncated portion of the script for subprocess/network/file operations or extract specific lines to review for potential exfiltration.

Like a lobster shell, security has layers — review code before you run it.

latestvk97df0ra0km0s55k1r7ng9dmjd8523bj
71downloads
0stars
1versions
Updated 1w ago
v1.0.0
MIT-0
@chanvging
latest
Download

全能日期管家

数据存储

所有数据保存在 {SKILL_DIR}/data/dates.json

支持的类型

类型说明特殊计算
生日人物生日计算年龄、同时显示公历农历
纪念日事件纪念日计算周年，10/20/50年显示婚龄名称
祭日人物忌日计算周年、情感化提示
祭祖传统节日祭祖清明、中元等传统节日

⚠️ 重要：必须使用脚本计算

禁止大模型自行计算日期！ 所有日期相关计算必须调用脚本，否则容易出错。

用户需求正确做法错误做法（禁止）
计算相差几天calc --date 2026-05-01自己算 (2026-05-01 - 今天)
10天后是几号calc --days 10今天 + 10 天
下周一几号calc --next-monday查日历自己推算
4月最后一天calc --month-end --month-end-month 4认为4月有30天
公历转农历convert --solar 1990-05-15自己查万年历

命令概览

命令功能示例
add添加记录添加生日、纪念日、祭日、祭祖
list查询列表查看所有/按类型筛选
get查看详情获取单条记录详细信息
today今日/近期今日和未来N天的日期
search搜索按名称/关系/备注搜索
update更新修改日期、提醒、备注等
delete删除删除记录
term节气查询24节气日期和倒计时
convert公历农历互转日期格式转换
calc日期计算下周一、月始月终等
holiday法定假日节日倒计时

add - 添加记录

基本用法

python {SKILL_DIR}/scripts/date_manager.py add "名称" --type 类型 --date 日期

公历生日

python {SKILL_DIR}/scripts/date_manager.py add "妈妈" --type 生日 --date 1980-05-15 --remind 3 --relation 母亲

农历生日

python {SKILL_DIR}/scripts/date_manager.py add "爸爸" --type 生日 --lunar 8-10 --remind 5 --relation 父亲

格式：--lunar 月-日

农历纪念日（指定年份）

python {SKILL_DIR}/scripts/date_manager.py add "结婚纪念日" --type 纪念日 --lunar 8-10 --year 2015 --remind 7 --relation 夫妻

祭日

python {SKILL_DIR}/scripts/date_manager.py add "爷爷" --type 祭日 --date 2020-03-15 --remind 2 --relation 祖父

纪念日

python {SKILL_DIR}/scripts/date_manager.py add "结婚纪念日" --type 纪念日 --date 2020-09-01 --remind 7 --relation 夫妻

祭祖（清明等传统节日）

python {SKILL_DIR}/scripts/date_manager.py add "清明" --type 祭祖 --date 2026-04-04 --remind 7

参数说明

参数说明必填
name名称（人名/事件名）✅
--type类型：生日/纪念日/祭日/祭祖默认生日
--date公历日期 YYYY-MM-DD与--lunar二选一
--lunar农历日期 月-日，如 8-10与--date二选一
--year农历对应的公历年份可选，配合--lunar使用
--remind提前提醒天数 1-30默认7
--relation关系/身份可选
--notes备注可选

list - 查询列表

查看所有

python {SKILL_DIR}/scripts/date_manager.py list

按类型筛选

python {SKILL_DIR}/scripts/date_manager.py list --type 生日
python {SKILL_DIR}/scripts/date_manager.py list --type 纪念日
python {SKILL_DIR}/scripts/date_manager.py list --type 祭日
python {SKILL_DIR}/scripts/date_manager.py list --type 祭祖

get - 查看详情

基本用法

python {SKILL_DIR}/scripts/date_manager.py get <ID>

说明

  • 获取单条记录的详细信息
  • 包含今年日期、倒计时、年龄/周年
  • ID 通过 list 或 search 命令获取

today - 今日/近期查询

未来7天（默认）

python {SKILL_DIR}/scripts/date_manager.py today

指定天数

python {SKILL_DIR}/scripts/date_manager.py today --days 30
python {SKILL_DIR}/scripts/date_manager.py today -n 30

输出说明

  • 今日有纪念日时高亮显示
  • 未来N天内的日期按倒计时排序
  • 显示本月总计数

search - 搜索

基本用法

python {SKILL_DIR}/scripts/date_manager.py search "关键词"

示例

python {SKILL_DIR}/scripts/date_manager.py search "妈妈"
python {SKILL_DIR}/scripts/date_manager.py search "结婚"

说明

  • 按名称、关系、备注搜索
  • 不区分大小写

update - 更新记录

基本用法

python {SKILL_DIR}/scripts/date_manager.py update <ID> [参数]

示例

# 修改日期
python {SKILL_DIR}/scripts/date_manager.py update abc123 --date 1980-05-20

# 修改提醒天数
python {SKILL_DIR}/scripts/date_manager.py update abc123 --remind 5

# 修改关系
python {SKILL_DIR}/scripts/date_manager.py update abc123 --relation 母亲

# 修改备注
python {SKILL_DIR}/scripts/date_manager.py update abc123 --notes "备注信息"

参数说明

参数说明
--date修改日期 YYYY-MM-DD
--remind修改提醒天数 1-30
--relation修改关系
--notes修改备注

delete - 删除记录

基本用法

python {SKILL_DIR}/scripts/date_manager.py delete <ID>

示例

python {SKILL_DIR}/scripts/date_manager.py delete abc123

term - 节气查询

查询下一个节气（默认）

python {SKILL_DIR}/scripts/date_manager.py term

查询指定节气

python {SKILL_DIR}/scripts/date_manager.py term --name 清明
python {SKILL_DIR}/scripts/date_manager.py term -n 小满

查询所有节气

python {SKILL_DIR}/scripts/date_manager.py term --all
python {SKILL_DIR}/scripts/date_manager.py term -a

24节气列表

节气日期范围说明
小寒01-05前后开始进入一年中最寒冷的日子
大寒01-20前后一年中最冷的时节
立春02-03/04春季的开始
雨水02-18/19降雨开始，雨量渐增
惊蛰03-05/06春雷始鸣，惊醒蛰虫
春分03-20/21昼夜等长，春季过半
清明04-04/05天清气明，万物洁齐
谷雨04-19/20雨生百谷，播种时节
立夏05-05/06夏季的开始
小满05-20/21小麦籽粒开始饱满
芒种06-05/06有芒作物成熟，抢收抢种
夏至06-20/21白昼最长，夏季过半
小暑07-06/07暑气渐盛
大暑07-22/23一年中最热的时节
立秋08-07/08秋季的开始
处暑08-22/23暑气消退
白露09-07/08露凝而白，早晚温差大
秋分09-22/23昼夜等长，秋季过半
寒露10-08/09露气寒冷，秋季渐深
霜降10-23/24天气渐冷，开始降霜
立冬11-07/08冬季的开始
小雪11-22/23开始降雪，但雪量不大
大雪12-06/07雪量增大
冬至12-21/22白昼最短，冬季过半

convert - 公历农历互转

公历转农历

python {SKILL_DIR}/scripts/date_manager.py convert --solar 2026-04-04
python {SKILL_DIR}/scripts/date_manager.py convert -s 1990-05-15

农历转公历

# 今年农历八月十五
python {SKILL_DIR}/scripts/date_manager.py convert --lunar 8-15

# 指定年份的农历日期
python {SKILL_DIR}/scripts/date_manager.py convert --lunar 8-10 --year 2015
python {SKILL_DIR}/scripts/date_manager.py convert -l 8-10 -y 2015

参数说明

参数说明
--solar公历日期 YYYY-MM-DD（公历转农历）
--lunar农历日期 月-日（农历转公历）
--year指定农历年份（默认今年）

calc - 日期计算

计算下周一

python {SKILL_DIR}/scripts/date_manager.py calc --next-monday
python {SKILL_DIR}/scripts/date_manager.py calc -m

计算本周星期几

python {SKILL_DIR}/scripts/date_manager.py calc --week Monday
python {SKILL_DIR}/scripts/date_manager.py calc -w Friday

计算N天后

python {SKILL_DIR}/scripts/date_manager.py calc --days 30
python {SKILL_DIR}/scripts/date_manager.py calc -n 100

计算月末日期

# 今年当月月末
python {SKILL_DIR}/scripts/date_manager.py calc --month-end

# 指定年月月末
python {SKILL_DIR}/scripts/date_manager.py calc --month-end --month-end-year 2026 --month-end-month 4

计算月初日期

# 今年当月月初
python {SKILL_DIR}/scripts/date_manager.py calc --month-start

# 指定年月月初
python {SKILL_DIR}/scripts/date_manager.py calc --month-start --month-start-year 2026 --month-start-month 5

计算指定日期差

python {SKILL_DIR}/scripts/date_manager.py calc --date 2026-05-01

参数说明

参数说明
--date目标日期 YYYY-MM-DD，计算与今天的差值
--next-monday计算下周一
--week本周星期几（Monday/Tuesday/Wednesday/Thursday/Friday/Saturday/Sunday）
--days计算N天后的日期
--month-end计算月末日期
--month-end-year指定年份（配合--month-end）
--month-end-month指定月份（配合--month-end）
--month-start计算月初日期
--month-start-year指定年份（配合--month-start）
--month-start-month指定月份（配合--month-start）

holiday - 法定假日查询

下一个假日（默认）

python {SKILL_DIR}/scripts/date_manager.py holiday

下一个假日

python {SKILL_DIR}/scripts/date_manager.py holiday --next
python {SKILL_DIR}/scripts/date_manager.py holiday -n

所有假日

python {SKILL_DIR}/scripts/date_manager.py holiday --all
python {SKILL_DIR}/scripts/date_manager.py holiday -a

主要法定假日

节日日期说明
元旦1月1日新年第一天
春节农历正月初一最重要的传统节日
清明节4月4/5日祭祖踏青
劳动节5月1日国际劳动节
端午节农历五月初五传统节日
中秋节农历八月十五团圆节日
国庆节10月1日国庆节

输出格式规范

添加成功（生日）

✅ 已添加

| 字段 | 值 |
|------|-----|
| ID | abc123 |
| 类型 | 生日 |
| 名称 | 妈妈 |
| 日期 | 1980-05-15 |
| 提醒 | 提前3天 |
| 关系 | 母亲 |

今年生日：5月15日 | 母亲46岁 | 还有3天

添加成功（纪念日/婚龄）

✅ 已添加

| 字段 | 值 |
|------|-----|
| 类型 | 纪念日 |
| 名称 | 结婚纪念日 |
| 日期 | 农历8月10日 |

距离11周年还有约4个月 | 💍 锡婚

今日查询

📅 4月17日

【今天】
- 暂无重要日子

【未来7天】
- 4月18日 妈妈生日 | 还有1天 | 母亲46岁
- 4月20日 清明祭祖 | 还有3天

【本月共3个】

祭日文案

🌸 爷爷祭日
第3周年 (2020-03-15)
建议：点一支蜡烛，给家人打个电话

祭祖文案

🏮 清明祭祖
还有7天
准备清单：香烛、纸钱、鲜花、供品

婚龄名称对照

周年名称
1年纸婚
2年布婚
3年皮婚
5年木婚
10年锡婚
15年水晶婚
20年瓷婚
25年银婚
30年珍珠婚
40年红宝石婚
50年金婚
60年钻石婚

注意事项

  1. 路径说明：{SKILL_DIR} 表示 skill 所在目录，使用时替换为实际路径
  2. 农历转换：需要安装 zhdate 库（如果不可用则某些功能受限）
  3. 节气计算：需要安装 chinese-calendar 库（如果不可用则使用备用数据，允许1-2天误差）
  4. 如果用户说"生日"但没给日期，引导用户提供
  5. 如果用户说"农历X月X日"，转换为 --lunar 月-日 格式
  6. 纪念日10周年以上自动标注婚龄名称
  7. 生日同时存储公历和农历，自动计算两个日期的倒计时

安装依赖

pip install zhdate chinese-calendar

如果提示缺少库，运行上述命令安装。

Comments

Loading comments...