官方节假日发现与同步
将以下提示词粘贴到你的 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` 的刷新边界。