国家法定节假日查询

从中国政府网（www.gov.cn）获取国务院办公厅发布的国家法定节假日安排通知。

使用场景

• - 查询某年的节假日放假安排
• 了解法定假日调休日期
• 获取春节、国庆等长假具体天数
• 确认是否需要补班调休

工作流程

第 1 步：确认查询年份

首先确认用户要查询的年份。如果用户未指定，默认使用当前年份。

第 2 步：获取节假日通知

运行脚本获取国务院办公厅发布的节假日安排通知：

bash
python scripts/fetch_holidays.py --year {年份}

此脚本采用缓存优先策略：

1. 1. 优先读取本地缓存：检查 assets/{年份}.md 是否存在
2. 缓存命中：直接返回缓存的节假日数据（毫秒级响应）
3. 缓存未命中：联网从政府网获取数据，并自动缓存到本地

预期输出： 国务院办公厅关于该年度部分节假日安排的通知全文（纯中文内容）

强制刷新（可选）

如需强制从网络获取最新数据（忽略缓存），添加 --force 参数：

bash
python scripts/fetch_holidays.py --year {年份} --force

触发场景： 当用户提到以下类似话术时，使用 --force 参数：

• - 重新从网络获取
• 强制更新缓存
• 刷新一下数据
• 重新下载
• 更新一下{年份}的缓存

第 3 步：解析并输出节假日信息

根据获取到的通知内容，按照用户要求整理输出：

标准输出格式：

【{年份}年国家法定节假日安排】

一、元旦：{具体日期}放假调休，共{天数}天。{调休说明}
二、春节：{具体日期}放假调休，共{天数}天。{调休说明}
三、清明节：{具体日期}放假调休，共{天数}天。{调休说明}
四、劳动节：{具体日期}放假调休，共{天数}天。{调休说明}
五、端午节：{具体日期}放假调休，共{天数}天。{调休说明}
六、中秋节：{具体日期}放假调休，共{天数}天。{调休说明}
七、国庆节：{具体日期}放假调休，共{天数}天。{调休说明}

示例

示例 1：查询 2026 年节假日

用户说： 帮我查一下 2026 年的节假日安排

操作：

1. 1. 确认年份：2026
2. 运行：python scripts/fetch_holidays.py --year 2026
3. 获取国务院办公厅通知内容
4. 整理输出节假日安排

结果：

【2026 年国家法定节假日安排】

一、元旦：1 月 1 日（周四）至 3 日（周六）放假调休，共 3 天。1 月 4 日（周日）上班。
二、春节：2 月 15 日（农历腊月二十八、周日）至 23 日（农历正月初七、周一）放假调休，共 9 天。2 月 14 日（周六）、2 月 28 日（周六）上班。
三、清明节：4 月 4 日（周六）至 6 日（周一）放假，共 3 天。
四、劳动节：5 月 1 日（周五）至 5 日（周二）放假调休，共 5 天。5 月 9 日（周六）上班。
五、端午节：6 月 19 日（周五）至 21 日（周日）放假，共 3 天。
六、中秋节：9 月 25 日（周五）至 27 日（周日）放假，共 3 天。
七、国庆节：10 月 1 日（周四）至 7 日（周三）放假调休，共 7 天。9 月 20 日（周日）、10 月 10 日（周六）上班。

说明： 脚本返回的是国务院办公厅通知原文。Agent 需要从中提取关键信息并整理输出：

• - 默认情况：按上述标准格式整理输出
• 用户指定格式：如果用户主动提供了输出格式要求或指定了输出模板，按照用户给定的要求整理输出（如 JSON、表格、列表、简短回复等）

示例 2：查询当年节假日

用户说： 今年放假怎么安排的？

操作：

1. 1. 确认年份：当前年份（2026）
2. 运行：python scripts/fetch_holidays.py --year 2026
3. 输出节假日安排

结果： 输出 2026 年全年节假日安排（格式同示例 1）

示例 3：强制刷新缓存

用户说： 重新从网络获取 2026 年的节假日数据

操作：

1. 1. 确认年份：2026
2. 运行：python scripts/fetch_holidays.py --year 2026 --force
3. 脚本会忽略本地缓存，重新从政府网获取数据

预期输出：
bash
$ python scripts/fetch_holidays.py --year 2026 --force
正在从网络获取 2026 年节假日数据...
找到通知：https://www.gov.cn/gongbao/2025/issue12406/202511/content7048922.html
正在获取通知内容...
已缓存到：skills/china-holidays/assets/2026.md

下方是通知原文内容

示例 4：查询特定节日

用户说： 2026 年春节放假几天？

操作：

1. 1. 确认年份：2026
2. 运行脚本获取数据
3. 从返回内容中提取春节相关信息

输出示例：

2026 年春节放假安排：
2 月 15 日（农历腊月二十八、周日）至 23 日（农历正月初七、周一）放假调休，共 9 天。
2 月 14 日（周六）、2 月 28 日（周六）上班。

示例 5：比较两年节假日安排

用户说： 对比一下 2025 年和 2026 年春节放假有什么不同

操作：

1. 1. 分别获取两年的节假日数据
2. 运行：python scripts/fetchholidays.py --year 2025 和 python scripts/fetchholidays.py --year 2026
3. 提取春节相关信息进行对比

输出示例：

2025 年 vs 2026 年春节放假对比：

2025 年春节：1 月 28 日（除夕）至 2 月 4 日（初七）放假，共 8 天
2026 年春节：2 月 15 日（腊月二十八）至 23 日（初七）放假，共 9 天

差异：2026 年比 2025 年多放 1 天，且 2026 年包含腊月二十八

示例 6：自定义输出格式

用户说： 用 JSON 格式输出 2026 年所有节假日安排

操作：

1. 1. 运行脚本获取数据
2. 按用户要求的 JSON 格式整理输出

输出示例：
json
{
year: 2026,
holidays: [
{name: 元旦, dates: 1 月 1 日 -1 月 3 日, days: 3, makeup_work: 1 月 4 日},
{name: 春节, dates: 2 月 15 日 -2 月 23 日, days: 9, makeup_work: 2 月 14 日、2 月 28 日},
{name: 清明节, dates: 4 月 4 日 -4 月 6 日, days: 3, makeup_work: 无},
{name: 劳动节, dates: 5 月 1 日 -5 月 5 日, days: 5, makeup_work: 5 月 9 日},
{name: 端午节, dates: 6 月 19 日 -6 月 21 日, days: 3, makeup_work: 无},
{name: 中秋节, dates: 9 月 25 日 -9 月 27 日, days: 3, makeup_work: 无},
{name: 国庆节, dates