企业微信日程管理。当用户需要预约日程、预订会议室、查看/更新/取消日程或查忙闲时触发。本技能负责『日程』——即不含在线会议链接的安排（也涵盖纯线下面对面碰头）；若用户要的是『在线会议』（含会议号/入会链接、可远程或视频参会），改用 wecomcli-meeting 技能。用户仅说'开会/约个会/某会'等、未明确要创建的是日程还是在线会议时，必须先读取本技能并按其中的消歧流程向用户追问确认后再处理，不可臆断直接创建。

企业微信日程技能执行任何 wecom cli 命令前，必须先读取并完成 wecomcli shared 技能的公共前置检查。适用范围适用预约 / 创建日程（含纯线下面对面碰头，即不带在线会议链接的安排）查看 / 浏览日程（今天有什么安排、查本周日程）搜索日程（按关键词、按组织人、按参与人找某个日程）更新 / 修改日程（改时间、改地点、加减人、换会议室；不支持更新周期日程）取消日程（不支持取消周期日程）查忙闲 / 约多人共同空闲时段订会议室、查会议室空不空、查办公楼不适用创建、更新、取消周期 / 重复日程（每周 / 每月 / 每天重复）→ 均不支持，引导用户在企业微信客户端手动操作回复 / 拒绝日程邀请（接受 / 拒绝 / 待定，含"拒绝这个日程""不参加"）→ 不支持，引导用户在企业微信客户端操作或私信发起人易混淆场景路由用户要创建含在线会议链接的会议（需会议号 / 入会链接 / 远程或视频参会）→ 改用 wecomcli meeting （创建会议会同时生成日程，无需在本技能再建）用户仅说"开会 / 约个会 / 安排个会 / xx 会"等、未明确是日程还是在线会议（创建场景）→ 必须先用文字追问消歧（固定问题"需要创建日程还是会议？"，请用户回复"日程 / 会议"），不得臆断直接创建用户要的会同时支持线下与远程参会（如"线下开、外地同事远程接入"）→ 含在线会议链接，改用 wecomcli meeting 仅给了地点 / 会议室号（如"在 1605 开会""订个会议室开会"）→ 不构成"明确是日程"，仍需先用文字询问消歧，不能因带地点就跳过追问查询场景的模糊表述（"最近有什么会 / 有哪些会"）→ 严禁追问，日程和会议都查并合并展示；仅当明确提到"在线会议 / 视频会议 / 入会链接 / 会议号 / 腾讯会议 / 远程参会"时才改用 wecomcli meeting 只查会议路由规则用户意图参考文档预约日程、安排纯线下面对面会议（不含在线会议链接）、创建日程 [calendar create](references/calendar create.md) 看日程、今天有什么安排、查本周日程 [calendar agenda](references/calendar agenda.md) 找某个日程、项目评审是什么时候 [calendar search](references/calendar search.md) 查日程详情、看周期规则、看会议链接 [calendar agenda](references/calendar agenda.md) 取消日程、不开了 [calendar cancel](references/calendar cancel.md) 修改日程、更新日程、改时间、加人/移除人、换会议室 [calendar update](references/calendar update.md) 查忙闲、某人什么时候有空、约多人共同空闲 [calendar freebusy](references/calendar freebusy.md) 订会议室、查会议室空不空、查办公楼、约会议室 [calendar meeting room](references/calendar meeting room.md) 浏览 vs 搜索的选择原则：用户提到日程主题关键词时走搜索；只给了时间/日期而无日程主题关键词时，必须走列表浏览（ list ）。需要周期规则、会议链接等详情时再读取单条日程详情补充。技能边界：日程 vs 会议 [CRITICAL] 本技能（wecomcli calendar）只负责日程 ——即非会议的日程安排，以及不含在线会议链接的纯线下面对面会议。只要涉及在线会议链接（含远程/视频参会）的会议，一律归 wecomcli meeting 技能，不在本技能创建。用户意图归属技能预约日程、安排纯线下面对面会议（不含在线会议链接）、订会议室、查/改/取消日程、查忙闲本技能 wecomcli calendar 创建含在线会议链接的会议、需要会议号或入会链接的会、需要远程/视频参会的会 wecomcli meeting 技能消歧规则（仅创建场景）：用户仅说"会议/会/开个会/约个会/安排个会/xx会/xx会议"等而未明确是日程还是会议时，必须先用文字追问，再路由到对应技能，禁止默认直接创建日程。此文字消歧仅用于「创建」；查询场景严格禁止追问——明确指向在线会议时只查会议，明确是日程/安排时只查日程，模糊表述（"会 / xx会 / 最近有什么会"等）则日程和会议都查（见下文「查询消歧」）。问题与选项固定 [CRITICAL] ：消歧确认时，问题与可选项都必须原文照用、严格禁止修改任何内容——问题固定为 "需要创建日程还是会议？" ，可选项固定为日程 / 会议；不得改写问题措辞、增减或改写选项、翻译，或自行设计其他表述（如"在线会议 / 线上会议 / 视频会议 / 线下会议"等）。用文字向用户提问：需要创建日程还是会议？（请回复：日程 / 会议） "会议""会""开会"等词本身不构成"明确" [CRITICAL] ：这些词只表示要碰头议事，并未说明是日程还是会议。禁止仅因 query 里出现"会议"二字就默认归本技能（日程）创建，也禁止反向默认成会议——只要未明确，一律先用文字追问后再路由。只有出现"碰个面/创建日程"等纯线下信号时才直接留在本技能。用户答「日程」→ 留在本技能，按"预约日程工作流"创建日程。用户答「会议」→ 改用读取 wecomcli meeting 技能创建会议（创建会议会同时生成对应日程，无需在本技能再建一条）。用户已明确（如"碰个面""创建日程"=日程；"发个入会链接""要会议号""远程参会"=会议）时，直接路由，无需追问。同时支持线下与远程参会（如"线下开、外地同事远程接入"）时，因含在线会议链接，归 wecomcli meeting 技能：创建会议即同时生成日程，无需在本技能另建日程。仅有地点/会议室号（如"在 1605 开会""到 A 座会议室碰一下""订个会议室开会"）不构成"明确是日程"——会议室里同样可能要远程接入，是日程还是会议仍未知，必须先用文字询问消歧，不能因为带了地点就跳过追问。改约 / 重建日程前必须先识别会议关联 [CRITICAL] "改约 / 改时间 / 挪到 / 顺延 / 重新约"等改期意图（即使用户说"取消……再约到……"，带"取消"也算改期），禁止机械拆成 cancel + create ： 1. 先定位再判定会议关联： search / list 返回均含 meeting 字段，定位到目标日程后直接检查 meeting.meeting code ——非空为「含在线会议链接的会议形态日程」，为空为纯日程；无需为此再补一次读取日程详情（仅当还需 repeat rule 等字段时才补）。 2. 纯日程 → 用本技能路由表中更新日程意图改时间，禁止 cancel + create。 3. 含会议链接 → 改用读取 wecomcli meeting 技能，把 meeting.meeting id 传入 meeting update 改时间（保留会议链接与参会人），无需重新 search 定位。根因： create 只能建纯日程、重建不出会议链接（能拆不能合），cancel + create 会让会议链接永久丢失，故改约一律走 update。核心场景 1. 预约日程读取 [calendar create](references/calendar create.md)，按其中"预约日程工作流"执行（信息补全 → 参与人解析 → 时间协商/忙闲检查 → 执行创建 → 结果反馈）。 2. 查看/搜索日程场景参考文档泛泛查询（"今天有什么安排"） [calendar agenda](references/calendar agenda.md) 有关键词（"项目评审是什么时候"） [calendar search](references/calendar search.md) 需要详情（只拿到 schedule id 时补齐字段） [calendar agenda](references/calendar agenda.md) 浏览 vs 搜索：有日程主题关键词 → 搜索（不追问时间）；只给时间/日期而无主题关键词 → 列表浏览（ list ），禁止把日期当 keywords 喂给 search 。列表浏览已返回 repeat rule ，无需额外读取单条详情判断是否周期日程。查询消歧（模糊查询时日程 + 会议都查）[REQUIRED] ：查询场景严格禁止用文字追问"是日程还是会议"——日程/会议消歧追问仅用于创建，查询时一律按以下规则直接处理、不追问。判定分两个独立维度，不要混为一谈：维度一：查哪一边（日程 / 会议 / 两边都查）明确是在线会议 → 用户明确提到"在线会议 / 视频会议 / 入会链接 / 会议号 / 腾讯会议 / 远程参会"等在线会议专属特征时，改用读取 wecomcli meeting 技能只查会议。明确是日程 / 安排 → 用户说的明显是日程类内容（如"日程 / 安排 / 我的安排 / 日历 / 今天有什么安排"，且不带在线会议特征）时，只查日程。模糊表述无法判定（"会 / xx会 / xx会议 / 开会 / 最近有什么会 / 有哪些会 / 找下 xx会议"等，既可能是日程也可能是会议）→ 日程和会议都要查：既查日程，又读取 wecomcli meeting 技能查会议。维度二：每一边用 search 还是 list （与维度一独立，逐边各自判断）有主题/名称关键词（如"找下 xx会议""项目评审是什么时候"）→ 该边用 search （把关键词传入 keywords ）。只有时间/日期或泛浏览无关键词（如"最近有什么会""今天有什么安排"）→ 该边用 list ，禁止把日期当 keywords 喂给 search 。即使"两边都查"，也按本维度对每一边各自选择：带关键词时两边都用 search ，纯时间/泛浏览时两边都用 list 。合并展示：两边都查时，合并结果后统一展示——按是否含在线会议链接分成「（会议）」（来自会议侧、或日程中 meeting.meeting code 非空者）和「（日程）」（ meeting code 为空的纯日程）两部分，同一场会议在两边都出现时按"主题 + 时间"去重只保留一条，末尾汇总"共 N 场，其中会议 X 场、日程 Y 场"。本消歧仅针对查询；创建场景仍按上文"日程 vs 会议"用文字追问。 3. 取消日程先定位日程（有日程主题关键词走搜索；只给时间/日期而无主题关键词走列表浏览 list ，禁止把日期当 keywords 喂给 search ），再判断是否周期日程（可直接读取列表返回的 repeat rule ，无需额外读取单条详情）—— 周期日程不支持取消，告知用户并引导其在企业微信客户端操作（见「已知限制」）。普通日程不预先按"是否本人创建"拦截取消，直接执行取消并根据工具返回结果判断能否取消（成功返回 {} ，无权限则返回错误，此时告知用户并建议联系创建人）。若用户意图实为"改约 / 挪到 / 顺延"（即使带"取消"字样），按上文「改约 / 重建日程前必须先识别会议关联」走更新流程。完整流程见 [calendar cancel](references/calendar cancel.md)。 4. 更新日程先定位日程（有日程主题关键词走搜索；只给时间/日期而无主题关键词走列表浏览 list ，禁止把日期当 keywords 喂给 search ），判断是否周期日程—— 周期日程不支持更新，告知用户并引导其在企业微信客户端操作（见「已知限制」），禁止逐场 update 拼凑或改为取消重建。普通日程收集修改内容后执行更新，不预先按"是否本人创建"拦截修改，直接执行更新并根据工具返回结果判断能否修改（成功返回更新后的 detail ，无权限则返回错误，此时告知用户并建议联系创建人）。改时间/改地点/加减人/换会议室都走更新，不要取消重建。换会议室时须先经 rooms search 确认新会议室 status=bookable 再把新 meeting room id 传入更新（见 [calendar meeting room](references/calendar meeting room.md)）。含在线会议链接的日程（定位结果中 meeting 非空）改时间不在本技能 update ，须改用读取 wecomcli meeting 技能（见上文「改约 / 重建日程前必须先识别会议关联」）。更新日程的完整流程见 [calendar update](references/calendar update.md)。 5. 查询忙闲 / 共同空闲查询参与人在指定时段的可用空闲时段（服务端已合并区间、过滤过去、按策略推荐），用于协调日程时间。详见 [calendar freebusy](references/calendar freebusy.md)。核心概念日程（Schedule）：日程系统中的单个事件，含主题、起止时间、参与人等属性。全天日程（All day）： is all day=true ，只按日期占用，结束日期包含在日程内。周期日程（Recurring）： repeat rule.is repeat=true ，按规则重复出现。参与人（Attendee）：以 userid （ wo 前缀）标识。用户提供的是姓名时通过读取 wecomcli contact 技能解析为 userid 。忙闲（FreeBusy）：查询参与人在指定时段是否有日程占用。地点（Location）：日程的地点为一段自由文本（ location 字段）。用户给的地点是公司会议室时，须经会议室查询（ rooms search ）预订、以 meeting room id 占用（见 [calendar meeting room](references/calendar meeting room.md)），不要把会议室名仅写进 location ；用户给的是非会议室的普通文本地点时才直接写入 location 。会议室 / 办公楼（Meeting Room / Building）：物理空间资源（与在线会议链接无关）。 buildings list 查可访问办公楼， rooms search 查会议室可订性，创建日程时传 meeting room id 原子占用，更新日程时传 meeting room id 改订。详见 [calendar meeting room](references/calendar meeting room.md)。时区（Timezone）：每个日程带 timezone （ timezone id + timezone offset ）。日程的 begin time / end time 是该时区下的墙上时间，后台不做转换——传入和返回的时间字符串都按日程时区解释，禁止自行换算成东八区或本地时间。核心规则规则 1: userid 获取 [CRITICAL] attendees / add attendees / remove attendees / userids / has attendees 等所有"成员 userid 列表"入参统一为对象数组，格式为 [{"userid": "woxxx"}, {"userid": "woyyy"}] ，不接受姓名或平铺字符串数组。 organizer （搜索按组织人）为单值，传 userid 字符串（ wo 前缀），不是数组。用户提供的是姓名时，通过读取 wecomcli contact 技能解析为对应 userid；多候选人时列出供用户选择，不自行猜测。禁止把姓名当 userid 拼接，禁止凭记忆或猜测编造 userid。原因：日程 API 不支持用姓名匹配参与人，传入姓名会导致静默失败或邀请到错误的人。规则 2: 写操作直接执行创建日程、取消日程时，参数就绪后直接执行，无需向用户展示摘要或询问确认。结果返回时禁止暴露 userid ，只展示人名。原因：上层交互已完整展示操作内容并完成确认，此处再展示一遍会造成冗余。规则 3: 用户交互必须用文字询问 [CRITICAL] 任何操作中，当必要参数不明确或需要用户做出选择时，必须用文字直接向用户提问，禁止自行猜测或使用默认值代替询问。提问时把可选项 / 候选值一并写进文字里，让用户直接回复。以下情况均适用此规则：必填参数及参与人缺失：创建日程的必填参数（ subject / begin time / end time ）以及参与人 attendees 无法从上下文中推断时，必须用文字询问；其余非必填参数（如地点）用户未明确指定时不专门询问，直接走默认值多候选项需用户选择：搜索返回多个匹配日程、wecomcli contact 技能搜索到多个同名候选人操作范围需确认：如更换会议室时查到多个 bookable 候选，需用户选定具体一个冲突处理：忙闲检查发现时间冲突，需用户决策文字询问的约束：列出的可选项 / 候选建议以 2~4 个为宜。可选候选多于 4 个时（如同名候选人、多个匹配日程），取最相关的前 4 个列出，并提示用户可进一步缩小范围（输入更精确的关键词 / 完整姓名 / 具体时间），不要一次性罗列 5 个及以上候选。询问时间时，列出的候选时刻必须是精确到分钟的具体时刻（如"明天 14:00"、"周六 10:30"），禁止给出"上午/下午/傍晚/午间/上班后/下班前"等模糊时间选项——模糊选项会导致用户回复后仍需二次追问具体几点，必须一次问到可直接落为 begin time 的精确时刻。规则 4: 任务简洁原则只完成用户要求的操作，不额外添加其他操作。规则 5: 输入合法性检查执行写操作前，验证以下输入的合法性：时间格式：必须为 YYYY MM DD HH:mm:ss ，拒绝模糊表述直接传参（如"明天"不能直接传入，需先解析为具体时间）时间顺序： end time 必须晚于 begin time ，拒绝零时长或负时长日程 userid 格式：必须为 wo 前缀的字符串，不接受纯数字或中文姓名历史时间：禁止创建完全在当前时刻之前的日程规则 6: 输入安全处理用户提供的是姓名时，必须经过读取 wecomcli contact 技能搜索验证后才能转换为 userid。禁止把姓名直接拼接为 userid，禁止凭记忆或猜测编造。原因：用户输入的字符串可能不对应真实员工（姓名不唯一、已离职等），直接拼接会导致将日程邀请发送给错误的人，且此类错误无法被 API 在调用时拦截。操作参考操作参考读取时机说明 [ calendar agenda ](references/calendar agenda.md) 查看/获取日程详情时查看日程安排（list + get） [ calendar create ](references/calendar create.md) 创建日程时创建日程并邀请参与人 [ calendar search ](references/calendar search.md) 搜索日程时按关键词搜索日程 [ calendar cancel ](references/calendar cancel.md) 取消日程时取消日程（不支持周期日程） [ calendar update ](references/calendar update.md) 更新/修改日程时更新日程信息（主题、时间、参与人、地点等） [ calendar freebusy ](references/calendar freebusy.md) 需要协调时间 / 查共同空闲时查询共同空闲时段，协调日程时间 [ calendar meeting room ](references/calendar meeting room.md) 预订/更换会议室 / 查办公楼或会议室可订性时办公楼清单（ buildings list ）+ 会议室可订性（ rooms search ），拿 meeting room id 供创建占用或更新改订上下文传递表此表描述接口间的数据流转契约，第一列"来源操作"为业务语义；各操作的完整参数与字段定义见对应 reference。来源操作从返回中提取用于搜索（search） schedules[].schedule id 单条详情、取消日程列表浏览 / 单条详情（list / get） schedule list[].schedule id 单条详情、取消日程搜索（search） schedules[].attendees[].name 直接展示参与人姓名，无需额外反查（搜索接口已返回）搜索（search） schedules[].creator name 直接展示日程创建者姓名搜索（search） next cursor + has more 分页翻页控制 wecomcli contact 技能搜索 userid （ wo 前缀）创建/更新日程的 attendees / add attendees / remove attendees 、忙闲查询的 userids 、搜索的 has attendees （均组装为对象数组 [{"userid": "woxxx"}] ）；搜索的 organizer 为单值 userid 字符串搜索 / 列表浏览 / 单条详情 repeat rule 判断是否周期日程（ is repeat=true ）：命中时取消 / 更新均不支持，告知用户并引导企业微信客户端操作； search / list 均直接返回，无需补 get 搜索 / 列表浏览 / 单条详情 meeting.meeting code 识别该日程含在线会议链接（非空即「会议形态日程」，search/list/get 均直接返回，无需额外补 get ）；改约 / 取消含会议链接日程时，直接把 meeting.meeting id 传入 wecomcli meeting 的 meeting update / meeting cancel ，无需在 wecomcli meeting 重新 search 定位搜索 / 列表浏览 + 单条详情搜索取 schedules[].schedule id 、列表/详情取 schedule list[].schedule id 与 schedule list[].repeat rule 更新日程的定位与周期日程判断（命中周期日程则不支持更新）忙闲查询 slots[] （含 available users 、 available count 、 busy users ）直接展示推荐时段，挑前几个让用户选择；展示时只用人名，userid 仅回传创建日程的 attendees 会议室可订性查询（ rooms search ） target[].room.meeting room id 或 recommendations[].meeting room id 创建日程的 meeting room id （原子占用会议室）、更新日程的 meeting room id （改订会议室）；ID仅工具链流转，禁止展示，对用户只露会议室 name 错误处理原则：告诉用户出了什么问题 + 可以怎么做 + 备选方案。禁止静默失败。场景恢复建议搜索无结果用文字提供恢复建议：1. 更换关键词重试；2. 按组织人搜索（提供姓名，解析 userid 后传 organizer ）；3. 按参与人搜索（提供姓名，解析 userid 后传 has attendees ）；通讯录多候选人用文字列出候选人（姓名+部门）供选择 wecomcli contact 技能搜索无结果用文字提示用户确认姓名，等待重新输入取消/修改非本人创建的日程不预先拦截，直接执行命令；返回权限错误时说明当前用户无权操作，建议联系创建人共同空闲查询返回空 slots 引导用户扩大时间窗口或减少参与人，不要在同一窗口反复重试共同空闲查询降级（ available count < total count ）告知哪些人冲突、几人能参加，由用户决定是否按降级时段安排或更换时间输出质量标准好的输出应满足以下条件：日程列表：按开始时间升序排序，每条日程作为独立条目顺序输出（禁止 markdown 表格），每个条目只含主题、时间、参与人；超过 10 条只展示前 10 条参与人展示：原样使用接口返回的 attendees[].name 字段（完全与接口返回的格式保持一致，如返回 zhangsan(张三) 就展示 zhangsan(张三) ），不展示 userid 操作结果：明确告知成功/失败及原因，操作成功后展示日程摘要错误提示：包含问题描述+恢复建议+备选方案，不暴露技术错误码不可接受的输出：直接展示 userid 而非姓名遇到错误静默失败，不给用户任何提示展示内部 schedule id 输出格式规范参与人姓名格式 [REQUIRED] ：所有展示参与人的场景（创建反馈、单条摘要、列表等），姓名一律原样使用接口返回的 attendees[].name 字段，完全与接口返回的格式保持一致（如返回 zhangsan(张三) 就展示 zhangsan(张三) ）；下文模板中的 {人名} 均指该原样 name。时间年份显示 [REQUIRED] ：下文"时间"行默认省略年份、只到月日（模板中的 {月日} 即指 M月D日）；仅当日程年份与当前年份不同（跨年）时，才在月日前补上年份，格式为 {YYYY}年M月D日 {HH:mm} {HH:mm} 。相对日期标签 [REQUIRED] ：当日程日期为昨天 / 今天 / 明天时，"时间"行在月日前加上相对词，格式 {昨天今天明天} M月D日 {HH:mm} {HH:mm} （如时间：明天 6月11日 14:00 15:00 ）；其余

wecomcli-calendar