Agent Skills
返回列表
官方节假日发现与同步

官方节假日发现与同步

数据分析 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_bbe5bc09/china-official-holiday-sync。

技能介绍

问题背景

中国法定节假日和调休安排只在发布当年由官方通知确定,第三方日历常出现来源不一致、字段不统一、未来年份提前猜测等问题。对需要排班、账单、报表或提醒的工程师来说,关键不是再维护一张静态日历,而是要把 gov.cn 的官方通知作为可信来源,并在没有发布时明确返回“未知”。

工作方式与边界

该技能采用保守同步流程:

  • 优先使用已配置来源:先读取本地 notice_urls,若目标年份已有确认 URL 且未显式刷新,则直接使用本地节假日数据。
  • 受控发现:根据请求年份与当前年份的距离判断是否允许探测;过远年份不发起探测,避免无效抓取。
  • 来源校验:只接受 https://www.gov.cn/zhengce/content/... 候选,通过标题和页面内容确认后再写入 notice_urls。
  • 结构化解析:从官方正文提取节假日区间与调休工作日,输出 date、is_holiday、is_workday、holiday_name、source_url 等字段。
  • 双层持久化:稳定来源保存在 notice_urls,探测历史保存在 discovery_cache,同一月份内的负面结果可复用。

它适合把官方节假日数据纳入数据分析管道,不适合依赖未发布通知生成未来排班,也不替代人工对特殊年份的解释。

使用场景

  • 排班工程师在生成下季度值班表前,需要把官方调休工作日解析成 `is_workday` 行。
  • 数据分析人员做年度报表时,需要按 `notice_urls` 校验目标年份是否已有官方节假日来源。
  • 日历产品工程师接入节假日接口时,需要只接受已验证的 `gov.cn/zhengce/content` URL。
  • 自动化工程师处理未来年份提醒时,需要在未发布年份返回无 URL 并记录当月负面探测。

适合人员

  • 负责排班系统的后端工程师:希望把官方调休规则落库为 `date`、`is_holiday`、`is_workday`。
  • 做经营分析的数据工程师:需要按年份从 `notice_urls` 取可信节假日字段做报表。
  • 构建日历提醒服务的产品工程师:要求未发布年份不猜测,只返回已验证 `gov.cn` 来源。
  • 做自动化数据管道的工程师:需要区分 `notice_urls` 与 `discovery_cache` 的刷新边界。