workday-calendarlisted

# 智能周历系统 (Workday Calendar) ## 触发条件 当用户出现以下意图时，加载本技能： - 查询或管理**法定假日**、**补班日**、**调休**安排 - 计算**年度工作日**、**工作日统计** - 生成**周历**、**日程安排** - 查询某天的**空闲时间**、**日程安排** - 添加、更新、删除**日程事件** - 说出关键词："周历"、"工作日"、"假日区间"、"日程"、"安排" --- ### 不触发（否定条件） 本技能在以下情况**不触发**： - 用户只是询问日期（如"今天几号"），无假日/工作日/日程管理意图 - 用户讨论日历 UI 组件设计（如"帮我画一个日历组件"），应触发 drawiodo 而非本技能 - 用户要求操作其他日历应用（如 Google Calendar、Outlook 日历），本技能仅管理本地数据 管理国家法定假日、补班日、自定义周末规则，计算年度工作日，生成周历，并支持个人日程管理。 ## 核心能力 > 📚 **渐进式加载**：本技能采用渐进式 MD 体系，`SKILL.md` 为入口（≤230行），详细内容拆分到 `references/*.md` 按需加载。 > 更多反模式详见 `references/antipatterns.md` > 更多 FAQ 详见 `references/faq.md` ### 📅 工作日计算 - **法定假日区间管理** - 以区间形式存储节假日，支持AI批量导入 - **补班日管理** - 单独记录调休上班日期 - **周末规则可配置** - 支持单休、双休、大小周等各类工时制度 - **工作日计算** - 自动计算年度总工日，优先级：补班 > 节假日 > 周末 ### 📊 日程管理 - **添加日程** - 指定日期、起止时间、标题、分类 - **删除/更新日程** - 支持CRUD完整操作 - **查询空闲时间** - 自动查找某日空闲时段 - **日程列表生成** - 自动生成未来N天日程文本 ## 工作流程 ### 首次使用 / 新年份 ``` 1. 初始化年度数据 → 2. 导入法定假日 → 3. 导入补班日 → 4. 核对规则确认表 → 5. 计算工作日 ``` ⚠️ **第4步必须执行**：使用 `rules` 命令查看规则确认表，核对节假日和补班日是否正确 ### 日程管理 ``` 添加日程 → 查询/更新 → 查找空闲时间 → 生成日程列表 ``` --- ## 使用指南 ### 1. 工作日计算 #### 计算年度总工日 ```python summary = calculate_total_workdays(2026) # 返回: # { # "year": 2026, # "total_workdays": 247, # "total_holidays": 118, # "holiday_count": 28, # "compensatory_count": 5 # } ``` #### 生成周历 ```python calendar = generate_weekly_calendar(2026) for week in calendar: print(f"第{week['week_number']}周") for day in week['days']: if day['date']: pri