wecomcli-calendar

企业微信日程技能

执行任何 wecom-cli 命令前，必须先读取并完成 wecomcli-shared 技能的公共前置检查。

适用范围

适用

• 预约 / 创建日程（含纯线下面对面碰头，即不带在线会议链接的安排）
• 查看 / 浏览日程（今天有什么安排、查本周日程）
• 搜索日程（按关键词、按组织人、按参与人找某个日程）
• 更新 / 修改日程（改时间、改地点、加减人、换会议室；不支持更新周期日程）
• 取消日程（不支持取消周期日程）
• 查忙闲 / 约多人共同空闲时段
• 订会议室、查会议室空不空、查办公楼

不适用

• 创建、更新、取消周期 / 重复日程（每周 / 每月 / 每天重复）→ 均不支持，引导用户在企业微信客户端手动操作
• 回复 / 拒绝日程邀请（接受 / 拒绝 / 待定，含"拒绝这个日程""不参加"）→ 不支持，引导用户在企业微信客户端操作或私信发起人

易混淆场景路由

• 用户要创建含在线会议链接的会议（需会议号 / 入会链接 / 远程或视频参会）→ 改用 wecomcli-meeting（创建会议会同时生成日程，无需在本技能再建）
• 用户仅说"开会 / 约个会 / 安排个会 / xx 会"等、未明确是日程还是在线会议（创建场景）→ 必须先用文字追问消歧（固定问题"需要创建日程还是会议？"，请用户回复"日程 / 会议"），不得臆断直接创建
• 用户要的会同时支持线下与远程参会（如"线下开、外地同事远程接入"）→ 含在线会议链接，改用 wecomcli-meeting
• 仅给了地点 / 会议室号（如"在 1605 开会""订个会议室开会"）→ 不构成"明确是日程"，仍需先用文字询问消歧，不能因带地点就跳过追问
• 查询场景的模糊表述（"最近有什么会 / 有哪些会"）→ 严禁追问，日程和会议都查并合并展示；仅当明确提到"在线会议 / 视频会议 / 入会链接 / 会议号 / 腾讯会议 / 远程参会"时才改用 wecomcli-meeting 只查会议

路由规则

浏览 vs 搜索的选择原则：用户提到日程主题关键词时走搜索；只给了时间/日期而无日程主题关键词时，必须走列表浏览（list）。需要周期规则、会议链接等详情时再读取单条日程详情补充。

技能边界：日程 vs 会议 [CRITICAL]

本技能（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，按其中"预约日程工作流"执行（信息补全 → 参与人解析 → 时间协商/忙闲检查 → 执行创建 → 结果反馈）。

2. 查看/搜索日程

浏览 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。

4. 更新日程

• 先定位日程（有日程主题关键词走搜索；只给时间/日期而无主题关键词走列表浏览 list，禁止把日期当 keywords 喂给 search），判断是否周期日程——周期日程不支持更新，告知用户并引导其在企业微信客户端操作（见「已知限制」），禁止逐场 update 拼凑或改为取消重建。普通日程收集修改内容后执行更新，不预先按"是否本人创建"拦截修改，直接执行更新并根据工具返回结果判断能否修改（成功返回更新后的 detail，无权限则返回错误，此时告知用户并建议联系创建人）。
• 改时间/改地点/加减人/换会议室都走更新，不要取消重建。 换会议室时须先经 rooms search 确认新会议室 status=bookable 再把新 meeting_room_id 传入更新（见 calendar-meeting-room）。
• 含在线会议链接的日程（定位结果中 meeting 非空）改时间不在本技能 update，须改用 读取 wecomcli-meeting 技能（见上文「改约 / 重建日程前必须先识别会议关联」）。
• 更新日程的完整流程见 calendar-update。

5. 查询忙闲 / 共同空闲

查询参与人在指定时段的可用空闲时段（服务端已合并区间、过滤过去、按策略推荐），用于协调日程时间。详见 calendar-freebusy。

核心概念

• 日程（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），不要把会议室名仅写进 location；用户给的是非会议室的普通文本地点时才直接写入 location。
• 会议室 / 办公楼（Meeting Room / Building）：物理空间资源（与在线会议链接无关）。buildings list 查可访问办公楼，rooms search 查会议室可订性，创建日程时传 meeting_room_id 原子占用，更新日程时传 meeting_room_id 改订。详见 calendar-meeting-room。
• 时区（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 在调用时拦截。

操作参考

上下文传递表

此表描述接口间的数据流转契约，第一列"来源操作"为业务语义；各操作的完整参数与字段定义见对应 reference。

错误处理

原则：告诉用户出了什么问题 + 可以怎么做 + 备选方案。禁止静默失败。

输出质量标准

好的输出应满足以下条件：

• 日程列表：按开始时间升序排序，每条日程作为独立条目顺序输出（禁止 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）；其余日期按 {月日} {HH:mm}-{HH:mm} 展示。

创建成功反馈 [REQUIRED]：创建日程成功后，输出内容只包含三部分：主题、时间、参与人，禁止输出其他任何内容和额外语句（不展示地点、提醒、schedule_id 等字段，也不附加说明、建议或寒暄）：

主题：{subject}
时间：{月日} {HH:mm}-{HH:mm}
参与人：{人名1}、{人名2}

单条日程摘要（用于查看/搜索单条场景，非创建反馈）：

主题：{subject}
时间：{月日} {HH:mm}-{HH:mm}
参与人：{人名1}、{人名2}

日程列表展示规范 [REQUIRED]（列表/搜索浏览均适用）：

• 禁止使用 markdown 表格；每条日程作为独立条目顺序输出，按开始时间升序排序。
• 每个条目 只展示三项：主题、时间、参与人（不展示地点、提醒、schedule_id 等）。
• 超过 10 条时只展示前 10 条，并在末尾告知"还有 N 条，需要查看更多吗？"。
• 会议 / 日程 分两部分展示：判断依据是该日程是否带有会议链接——meeting.meeting_code 有值（非空）归为「会议」，为空 / 不存在归为「日程」（search/list/get 返回均含 meeting 字段，可直接判断）。仅当本次结果中同时存在「会议」和「日程」两类时，才把结果分成「（会议）」和「（日程）」两个部分分别展示：先列「（会议）」部分、再列「（日程）」部分；每部分内部按开始时间升序、逐条只展示主题/时间/参与人；末尾追加汇总"共 N 场，其中会议 X 场、日程 Y 场"。当结果只有单一类别时（全是会议或全是日程），不分部分、不加「（会议）」/「（日程）」标题，按普通列表直接展示。
• 分部分格式：

（会议）
1. {主题}
   时间：{月日} {HH:mm}-{HH:mm}
   参与人：{人名1}、{人名2}

（日程）
1. {主题}
   时间：{月日} {HH:mm}-{HH:mm}
   参与人：{人名1}、{人名2}

时区标注 [REQUIRED]：日程 timezone_offset != 28800（非东八区）时，展示时间必须带时区标注，格式 {HH:mm}-{HH:mm}（{地区中文名} UTC±N），如 14:00-15:00（纽约时间 UTC-5）。

• UTC±N 由 timezone_offset / 3600 得出。
• 地区中文名由 timezone_id 推导（如 America/New_York → 纽约时间）；timezone_id 为空时省略中文名，只留 （UTC-5）。
• 东八区（timezone_offset = 28800，含 Asia/Shanghai、Asia/Singapore 等）不标注，保持现状。
• 适用于单条摘要的"时间"行、日程列表、创建/更新成功反馈；freebusy 的 slots 不适用（按本人时区展示）。

已知限制