节假日安排

要解决什么问题

排期、请假、值班轮值或对外承诺「下个工作日」时，单靠星期几不够：国庆调休、春节连休、周末补班都会把日历算错。本技能面向中国大陆公历日期，把「这天算不算休息、叫什么节、是否在连休里」收成结构化结果，方便脚本和 Agent 直接消费。

如何工作

核心入口是 scripts/check_holiday.py：传入 YYYY-MM-DD，省略则查当天；也可在 Python 里当作模块调用。成功时返回 JSON，主要字段包括：

• is_holiday：是否为休息日（含法定节假日与周末）
• holiday_type：法定节假日 / 调休工作日 / 周末 / 工作日 等
• holiday_name：节假日名称；普通工作日多为 null
• rest_info：连休说明，例如起止日期文案，便于再解析出日期序列

法定与调休数据来自开源项目 holiday-cn（依据国务院公告，覆盖 2004 年起各年）。调休工作日会被标成休息日以外的类型，但仍可能带名称，需要同时看 is_holiday 与 holiday_type，不要只盯布尔值。

法定节假日之外的传统节日（元宵、七夕、重阳等）存放在 references/traditional_holidays.json；它们是农历日期，本技能不提供农历转公历，不能单靠一次查询自动落在具体公历日上。

边界与注意点

• 首次拉取某年份数据时需要网络；年份范围一般为 2004–2030（随数据源更新而变）。
• 批量查询、根据 rest_info 展开连休日期，需在调用方自行循环或解析字符串。
• 更细的字段语义与集成方式见技能内 references/api_reference.md。