← Back to Skills Marketplace
chanvging

纪念日管理

by chanvging · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
77
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install date-manager
Description
私人日期管家。**重要：所有日期计算（包括相差天数、下周一、月末等）必须使用 calc 命令，不要自己计算，避免出错。** 支持公历和农历计算，提供提醒和情感化文案。触发场景：(1)用户提到生日、纪念日、忌日、祭祖、清明等关键词 (2)用户说"记录XXX的生日"、"记一下XXX" (3)用户问"今天有什么日子"、...
README (SKILL.md)

全能日期管家

数据存储

所有数据保存在 {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 \x3CID>

说明

  • 获取单条记录的详细信息
  • 包含今年日期、倒计时、年龄/周年
  • 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 \x3CID> [参数]

示例

# 修改日期
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 \x3CID>

示例

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

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

Usage Guidance
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.
Capability Analysis
Type: OpenClaw Skill Name: date-manager Version: 1.0.0 The 'date-manager' skill is a legitimate utility for tracking birthdays, anniversaries, and traditional Chinese holidays. The Python script (date_manager.py) implements standard CRUD operations using a local JSON file for storage and utilizes well-known libraries (zhdate, chinese-calendar) for date conversions. No evidence of data exfiltration, malicious execution, or harmful prompt injection was found; the instructions in SKILL.md are focused on ensuring calculation accuracy by directing the AI to use the provided script rather than relying on internal LLM logic.
Capability Assessment
✓ 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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install date-manager
  3. After installation, invoke the skill by name or use /date-manager
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
date-manager 1.0.0 - 首发上线：全能私人日期管理工具，支持全中英文 CLI 指令和数据存储。 - 支持多类型重要日子管理：生日、纪念日、祭日、祭祖，涵盖公历与农历。 - 强制脚本日期计算（calc/convert 等），避免手算误差。 - 提供提醒、情感化文案、节气与节假日倒计时、农历互转等功能。 - 覆盖添加、列表、搜索、修改、删除、日期计算等全套指令。
Metadata
Slug date-manager
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is 纪念日管理?

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

How do I install 纪念日管理?

Run "/install date-manager" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is 纪念日管理 free?

Yes, 纪念日管理 is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does 纪念日管理 support?

纪念日管理 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created 纪念日管理?

It is built and maintained by chanvging (@chanvging); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191115 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments