Metadata

name: date-manager
description: 私人日期管家。**重要：所有日期计算（包括相差天数、下周一、月末等）必须使用 calc 命令，不要自己计算，避免出错。** 支持公历和农历计算，提供提醒和情感化文案。触发场景：(1)用户提到生日、纪念日、忌日、祭祖、清明等关键词 (2)用户说"记录XXX的生日"、"记一下XXX" (3)用户问"今天有什么日子"、"这周有什么纪念日" (4)用户想查询或管理重要日期 (5)用户问节气、农历转换、法定假日等 (6)用户要求计算日期相关（如相差几天、某天后是几号等)

全能日期管家

数据存储

所有数据保存在 {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年	钻石婚

注意事项

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

安装依赖

pip install zhdate chinese-calendar

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

纪念日管理

安装技能

全能日期管家

数据存储

支持的类型

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

命令概览

add - 添加记录

基本用法

公历生日

农历生日

农历纪念日（指定年份）

祭日

纪念日

祭祖（清明等传统节日）

参数说明

list - 查询列表

查看所有

按类型筛选

get - 查看详情

基本用法

说明

today - 今日/近期查询

未来7天（默认）

指定天数

输出说明

search - 搜索

基本用法

示例

说明

update - 更新记录

基本用法

示例

参数说明

delete - 删除记录

基本用法

示例

term - 节气查询

查询下一个节气（默认）

查询指定节气

查询所有节气

24节气列表

convert - 公历农历互转

公历转农历

农历转公历

参数说明

calc - 日期计算

计算下周一

计算本周星期几

计算N天后

计算月末日期

计算月初日期

计算指定日期差

参数说明

holiday - 法定假日查询

下一个假日（默认）

下一个假日

所有假日

主要法定假日

输出格式规范

添加成功（生日）

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

今日查询

祭日文案

祭祖文案

婚龄名称对照

注意事项

安装依赖