Wecomcli Schedule

1---2name: wecomcli-schedule3description: 企业微信日程管理技能。适用于用户对企业微信日程的各类管理需求。当用户需要：(1) 查询指定时间范围内的日程列表或获取日程详细信息（标题、时间、地点、参与者等），(2) 创建新日程并设置提醒、参与人等，(3) 修改已有日程的标题、时间、地点等信息或取消日程，(4) 添加或移除日程参与人，(5) 查询多个成员的闲忙状态并分析共同空闲时段以安排会议时使用此技能。4metadata:5  requires:6    bins: ["wecom-cli"]7  cliHelp: "wecom-cli schedule --help"8---9 10# 企业微信日程管理技能11 12> `wecom-cli` 是企业微信提供的命令行程序，所有操作通过执行 `wecom-cli` 命令完成。13 14 15通过 `wecom-cli schedule <接口名> '<json入参>'` 与企业微信日程系统交互。16 17## 注意事项18 19- 日程列表查询仅支持**当日前后 30 天**，时间格式 `YYYY-MM-DD` 或 `YYYY-MM-DD HH:mm:ss`20- 涉及参与者 userid 时，需先使用 **wecomcli-contact** 技能获取；存在同名时展示候选让用户选择（禁止暴露 userid）21- 创建/修改/取消前，先确认目标日程和参与者信息22- `errcode != 0` 时展示错误信息；返回的 `start_time`/`end_time` 为 Unix 时间戳（秒），需转为可读格式23- **注意时间格式转换**：接口入参使用字符串格式（如 `YYYY-MM-DD HH:mm:ss`），但返回值多为 Unix 时间戳，使用时需进行格式转换24 25---26 27## 接口列表28 29### get_schedule_list_by_range — 查询日程 ID 列表30 31```bash32wecom-cli schedule get_schedule_list_by_range '{"start_time": "YYYY-MM-DD HH:mm:ss", "end_time": "YYYY-MM-DD HH:mm:ss"}'33```34 35返回 `schedule_id_list` 数组。仅支持当日前后 30 天。36 37### get_schedule_detail — 获取日程详情38 39```bash40wecom-cli schedule get_schedule_detail '{"schedule_id_list": ["SCHEDULE_ID_1", "SCHEDULE_ID_2"]}'41```42 43支持 1~50 个 ID，返回日程标题、时间、地点、参与者等。参见 [API 详情](references/get-schedule-detail.md)。44 45### create_schedule — 创建日程46 47```bash48wecom-cli schedule create_schedule '{"schedule": {"start_time": "YYYY-MM-DD HH:mm:ss", "end_time": "YYYY-MM-DD HH:mm:ss", "summary": "日程标题", "attendees": [{"userid": "USER_ID"}], "reminders": {"is_remind": 1, "remind_before_event_secs": 3600, "timezone": 8}}}'49```50 51参见 [API 详情](references/create-schedule.md) | [reminders 字段](references/ref-reminders.md)。52 53### update_schedule — 修改日程54 55只需传入需修改的字段，未传字段保持不变。56 57```bash58wecom-cli schedule update_schedule '{"schedule": {"schedule_id": "SCHEDULE_ID", "summary": "更新后的标题"}}'59```60 61参见 [API 详情](references/update-schedule.md)。62 63### cancel_schedule — 取消日程64 65```bash66wecom-cli schedule cancel_schedule '{"schedule_id": "SCHEDULE_ID"}'67```68 69### add_schedule_attendees / del_schedule_attendees — 管理参与人70 71- 添加参与人：72```bash73wecom-cli schedule add_schedule_attendees '{"schedule_id": "SCHEDULE_ID", "attendees": [{"userid": "USER_ID"}]}'74```75- 移除参与人：76```bash77wecom-cli schedule del_schedule_attendees '{"schedule_id": "SCHEDULE_ID", "attendees": [{"userid": "USER_ID"}]}'78```79 80### check_availability — 查询闲忙81 82```bash83wecom-cli schedule check_availability '{"check_user_list": ["USER_ID_1", "USER_ID_2"], "start_time": "YYYY-MM-DD HH:mm:ss", "end_time": "YYYY-MM-DD HH:mm:ss"}'84```85 86支持 1~10 个用户，返回各用户的忙碌时段列表。参见 [API 详情](references/check-availability.md)。87 88---89 90## 典型工作流91 92### 查询日程93 94**经典 query 示例：**95- "我今天有哪些日程？"96- "帮我看看这周三下午有没有会议"97- "明天的日程安排是什么？"98- "查一下最近有没有关于项目评审的日程"99- "我下周一到周五的日程都有哪些？"100 101**流程：**1021. 根据用户意图计算时间范围（如"今天"→当日 00:00:00 至 23:59:59，"这周"→本周一至周日）1032. 调用 `get_schedule_list_by_range` 获取日程 ID 列表1043. 调用 `get_schedule_detail` 批量获取详情，将 Unix 时间戳转为可读时间1054. 若用户提到关键词（如"项目评审"），在 `summary` 中匹配筛选；未找到则逐步扩大范围至前后 30 天上限1065. 展示日程列表时包含标题、时间、地点、参与者等关键信息，方便用户快速了解107 108### 创建日程109 110**经典 query 示例：**111- "帮我创建一个明天下午 2 点到 3 点的会议，标题叫需求评审"112- "安排一个周五全天的团建活动"113- "创建日程：后天上午 10 点和张三、李四开产品方案讨论会，地点在 3 楼会议室"114- "帮我建个日程，下周一 14:00-15:00，提前 15 分钟提醒"115- "约一个明天上午的日程，邀请王伟参加"116 117**流程：**1181. 解析用户意图，提取时间、标题、地点、参与人、提醒设置等信息1192. 若涉及参与人，先通过 **wecomcli-contact** 查询 userid；存在同名时展示候选让用户选择1203. 若用户未指定提醒，默认设置提前 15 分钟提醒（`remind_before_event_secs: 900`）1214. 若用户说"全天"，设置 `is_whole_day: 1`，时间设为当天 00:00:00 至 23:59:591225. 向用户确认日程信息（标题、时间、地点、参与人等）后调用 `create_schedule`123 124### 修改日程125 126**经典 query 示例：**127- "把明天的需求评审改到后天下午 3 点"128- "帮我修改下今天下午的会议标题，改成技术方案评审"129- "我今天 14 点的日程地点改成线上腾讯会议"130- "把周五的团建活动推迟一个小时"131- "帮我给明天的周会加个描述：讨论 Q2 规划"132 133**流程：**1341. 先通过查询工作流定位目标日程（根据用户提到的时间、标题等关键词匹配）1352. 若匹配到多个日程，展示候选列表让用户确认1363. 向用户确认要修改的字段和目标值1374. 调用 `update_schedule`，只传入需修改的字段138 139### 取消日程140 141**经典 query 示例：**142- "取消明天下午的需求评审"143- "帮我把周五的团建日程删掉"144- "我不想开今天 15 点的会了，帮我取消"145 146**流程：**1471. 先通过查询工作流定位目标日程1482. 向用户确认取消的日程信息（标题、时间等），避免误操作1493. 确认后调用 `cancel_schedule`150 151### 管理参与人152 153**经典 query 示例：**154- "把张三加到明天的需求评审会议里"155- "帮我把李四从周五的日程里移除"156- "明天下午的会议再邀请一下王伟和赵敏"157- "把我后天那个技术分享的参与人里去掉刘强"158 159**流程：**1601. 通过 **wecomcli-contact** 获取目标人员 userid；存在同名时展示候选让用户选择1612. 通过查询工作流定位目标日程1623. 调用 `add_schedule_attendees` 或 `del_schedule_attendees` 完成添加/移除163 164### 查询闲忙并安排会议165 166**经典 query 示例：**167- "帮我看看张三和李四明天下午有没有空"168- "查一下我和王伟这周的空闲时间，想约个会"169- "我想跟产品组的小明、小红开个会，看看大家什么时候有空"170- "找一个明天下午大家都有空的时段，安排一个 1 小时的会议"171 172**流程：**1731. 通过 **wecomcli-contact** 获取相关人员 userid1742. 调用 `check_availability` 查询指定时间范围内各用户的忙碌时段1753. 分析所有用户的忙碌时段，计算出共同空闲时段并推荐给用户1764. 用户确认时段后，调用 `create_schedule` 创建会议并自动添加参与人