workday-calendar

智能周历系统 (Workday Calendar)

触发条件

正向触发：

• 查询或管理法定假日、补班日、调休安排
• 计算年度工作日、工作日统计
• 生成周历、日程安排
• 查询某天的空闲时间、日程安排
• 添加、更新、删除日程事件
• 说出关键词："周历"、"工作日"、"假日区间"、"日程"、"安排"
• 用户讨论日历 UI 组件设计（如"帮我画一个日历组件"），应触发 drawiodo 而非本技能
• 用户要求操作其他日历应用（如 Google Calendar、Outlook 日历），本技能仅管理本地数据

否定条件（不触发）

• 用户只是询问日期（如"今天几号"），无假日/工作日/日程管理意图
• 用户讨论日历 UI 组件设计（如"帮我画一个日历组件"），应触发 drawiodo 而非本技能
• 用户要求操作其他日历应用（如 Google Calendar、Outlook 日历），本技能仅管理本地数据

核心能力

📚 渐进式加载：本技能采用渐进式 MD 体系，SKILL.md 为入口（≤230行），详细内容拆分到 references/*.md 按需加载。

渐进式文件索引

工作流程

首次使用 / 新年份

当某年没有法定假日数据时（load_holiday_intervals(year) 返回空列表），必须主动联网查询国务院办公厅放假安排通知：

1. 联网查询 — 输入：年份 → 搜索"国务院办公厅 20XX年 放假安排" → 输出：法定假日日期范围、补班日、假期名称
2. 组织规则模板 JSON — 输入：查询结果 → 按 export_rules_template 格式组织 JSON → 输出：标准规则模板
3. 导入 — 输入：规则模板 → 调用 import_rules_from_template() → 输出：数据写入 JSON 文件
4. 核对 — 输入：已导入数据 → 运行 python scripts/workday_calendar.py rules 20XX → 输出：规则确认表
5. 计算 — 输入：确认无误的数据 → 调用 calculate_total_workdays(20XX) → 输出：年度工日统计

联网查询要求：

• 搜索关键词："国务院办公厅 20XX 年 放假安排"
• 获取：法定假日日期范围、调休上班日（补班）、假期名称
• 确认该年周末规则（通常为标准双休日六日）

组织规则模板（export_rules_template 格式）：

{
  "version": "1.0",
  "year": 2027,
  "base_type": "holiday",
  "rules": {
    "weekend_config": {"weekends": [0, 6]},
    "holiday_intervals": [
      {"name": "元旦", "start": "2027-01-01", "end": "2027-01-03"}
    ],
    "compensatory_days": [
      {"date": "2027-01-04", "note": "元旦补班"}
    ],
    "rotation_configs": [],
    "special_rests": []
  }
}

执行导入：

template = {上面组织好的 JSON}
import_rules_from_template(template)

导入后核对：

python scripts/workday_calendar.py rules 2027

⚠️ 核对步骤必须执行：节假日日期、补班日必须与国务院通知完全一致。

四层数据架构

底板(法定假休, 永远不变)
  └→ weekend_config(双休/单休/自定义周几)
      └→ 排班规则(轮休/公休/临修, 始终叠在 weekend_config 上)
          ├─ toggle OFF → 假休保留(不受排班影响)
          └─ toggle ON  → 排班全面覆盖(包括假休)
              └→ 个人日程(记事本, 永远最上层)

日期类型优先级

日程冲突检测

• 添加日程时自动检测时间冲突

• 更新日程时重新检测冲突，冲突则自动还原

• scripts/workday_calendar.py — 核心逻辑

• scripts/settings.py — 配置中心 Web 服务器