核心用法
chinese-calendar Skill 通过调用 timor.tech 免费 API，获取中国法定节假日及调休安排，解决单纯日期计算无法识别"调休补班"的痛点。
关键能力：
- 工作日判断：自动识别周末调休上班、节假日后补班等复杂场景
- 节假日查询：返回节日名称、工资倍数、休息天数等完整信息
- 批量日期处理：支持循环查询多日期，生成工作日历
典型调用方式：
# 单日期查询 curl -s "https://timor.tech/api/holiday/info/2026-02-28" # 年度节假日列表 curl -s "https://timor.tech/api/holiday/year/2026/"
API 返回结构化 JSON，包含 type（0=工作日, 1=周末, 2=节日, 3=调休）和 holiday 对象，通过 holiday.holiday 与 holiday.after 组合可精确区分：正常工作日、正常周末、法定节假日、调休补班四种状态。
显著优点
1. 数据权威性：直接同步国务院发布的年度节假日安排，每年自动更新
2. 场景精准：专为中文用户设计，完美处理中国特色的"调休"逻辑
3. 零成本接入：免费 API，无需注册认证，开箱即用
4. 多平台支持：提供 Bash 与 PowerShell 双版本示例，跨平台兼容
5. Agent 友好：返回结构化 JSON，便于自动化解析与决策
潜在局限
| 局限 | 说明 |
|------|------|
| 第三方依赖 | 数据源为 timor.tech 个人维护项目，非政府官方接口，存在服务稳定性风险 |
| 无 SLA 保障 | 免费服务，无可用性承诺，高峰期可能限流 |
| 农历缺失 | 不包含农历信息，需配合其他 Skill 使用 |
| 仅限中国 | 不支持港澳台差异及国际节假日 |
| 年份范围 | 主要覆盖当年及前后几年，历史久远年份数据可能不全 |
适合人群
- 自动化运维：需要根据工作日/假期调整定时任务、告警策略
- 企业办公：开发考勤系统、排班提醒、假期审批流
- 个人效率：构建智能日程助手，自动识别调休安排
- 爬虫/数据：需要过滤交易日、工作日进行数据采集
常规风险
- 服务中断风险：第三方免费 API 可能因维护、流量或项目终止而失效
- 数据延迟：国务院节假日安排通常在年末发布，年初可能存在短期数据空白
- 隐私泄露：请求包含具体日期，虽无敏感信息，但存在 IP 被记录的可能
- 错误依赖：不建议用于金融交易、法律合规等高风险场景的单一判断依据