Pinvou/pinvou-agent / pinvou3-app/src-tauri/resources/common/bundle/wecom-skills/wecomcli-calendar
wecomcli-calendar
Verified何时用:仅当用户明确指向企业微信日程/会议室预订/忙闲时使用;泛指记事、提醒、本地日程默认走本地工具,在线会议走 wecomcli-meeting。企微日程:预约/预订会议室/查看/更新/取消/查忙闲;仅说'开会/约个会'未明确日程还是在线会议时,先按本技能消歧流程追问,不可臆断直接创建。
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 29.3 KB |
| references/calendar-agenda.md | markdown | 14.9 KB |
| references/calendar-cancel.md | markdown | 7.1 KB |
| references/calendar-create.md | markdown | 25.6 KB |
| references/calendar-freebusy.md | markdown | 12.9 KB |
| references/calendar-meeting-room.md | markdown | 11.1 KB |
| references/calendar-search.md | markdown | 11.4 KB |
| references/calendar-update.md | markdown | 20.7 KB |
references/calendar-cancel.md
View on GitHub# calendar schedules cancel — 取消日程
取消用户发起的日程。**暂不支持取消周期日程**,识别到周期日程时应告知用户并引导其在企业微信客户端操作(见下文工作流与注意事项)。
> [!CAUTION]
> 这是**写入操作** — 取消日程前复述主题与时间并获确认;参数就绪后执行。
## 命令
```bash
# 取消普通日程
wecom-cli calendar schedules cancel --json '{"schedule_id": "<schedule_id>"}'
```
## 参数
| 参数 | 类型 | 必填 | 说明 |
|------|------|:----:|------|
| `schedule_id` | string | 是 | 要取消的日程 ID(由 search/list 返回,格式不固定,直接透传即可) |
**返回**:成功时返回空对象 `{}`,这是正常结果,不代表失败。收到空对象即可告知用户取消成功。
## 定位目标时的跨载体消歧(模糊取消)[REQUIRED]
用户说"取消那个会 / 取消 xx 会 / 把那个会取消掉"等模糊表述、未明确是日程还是在线会议时,**不要只在日程里找**——「会」可能是一条纯日程,也可能是含在线会议链接的会议,只查一边会漏定位:
- **明确是日程 / 安排**(说的是"日程 / 安排 / 我的日历"且不带在线会议特征)→ 只在本技能 `search`/`list` 定位,走 `schedule cancel`。
- **明确是在线会议**(提到入会链接 / 会议号 / 视频会议 / 腾讯会议 / 远程参会等专属特征)→ 改用 `读取 wecomcli-meeting 技能` 在会议里定位并 `meeting cancel`。
- **模糊无法判定** → 日程和会议**两边都查**:本技能 `search`/`list` + `读取 wecomcli-meeting 技能` 用同样关键词 / 时间查会议,合并候选、按"主题 + 时间"去重(同一场两边都命中只保留一条),再用文字让用户**选定要取消的唯一一条**;选定后按其归属路由——是纯日程 → `schedule cancel`;是会议(或两边都命中的同一场)→ 改用 `读取 wecomcli-meeting 技能` 走 `meeting cancel`(会连带取消关联日程,禁止再对该日程调用 `schedule cancel`)。
> **与查询消歧的区别**:查询时可以两边都查、都展示;但取消是**写操作,绝不能两边都直接取消**,模糊时必须先让用户确认唯一目标,再执行对应的 cancel。
## 取消日程工作流
```
用户发起取消意图
|
+-- 搜索目标日程
| +-- 有关键词 → search(不追问时间)
| +-- 有时间信息 → list 按时间范围查询
| +-- 都没有 → 用文字询问引导用户补全缺失的参数
|
+-- 匹配结果处理
| +-- 唯一匹配 → 继续
| +-- 多条匹配 → 用文字让用户选择目标日程:
| | 文字提问:"找到多个匹配日程,请选择要取消的一个:"
| | 列出候选(如"项目评审 - 4月8日 14:00 / 项目评审 - 4月15日 14:00",最多 4 条)
| +-- 无匹配 → 扩大搜索 / 提示换关键词
|
+-- 判定会议关联与周期性:meeting 与 repeat_rule 在 search/list 结果中已直接返回,直接判定,无需补 get
| +-- meeting.meeting_code 非空(含在线会议链接)
| | +-- 改期意图(改约/挪到/顺延,即使带"取消")→ 改用 `读取 wecomcli-meeting 技能`,把 meeting_id 传入 meeting update 改时间
| | +-- 纯取消(不办了/不要了)→ 改用 `读取 wecomcli-meeting 技能` 走 meeting cancel(会连带取消关联日程,禁止在此 schedule cancel)
| +-- meeting 为空(纯日程)
| +-- 普通日程 → 进入取消前确认(复述日程主题与时间并获确认,见 SKILL.md 规则 2)
| +-- 周期日程(repeat_rule.is_repeat=true)→ 终止操作,用文字告知用户:"目前暂不支持取消周期日程,请在企业微信客户端对该日程进行取消操作",禁止改为整系列直接 cancel 或其他变通方式
|
+-- 用户确认后执行 cancel(不论日程由谁创建,不提前拒绝)→ 依返回结果判断:
+-- 返回空对象 {} → 取消成功,报告结果
+-- 返回权限类错误 → 说明当前用户无权取消该日程,告知用户并建议联系日程创建人(creator_name)操作
```
## 典型场景
### 1. 取消普通日程
```
用户:帮我取消明天的项目评审
→ 调用 search(keywords=["项目评审"],明天)
→ 找到 1 条
→ 复述日程主题与时间并获用户确认
→ 调用 cancel(schedule_id)
→ 报告:已取消
```
### 2. 取消周期日程(不支持)
```
用户:帮我取消这周五的周会
→ 搜索 → 找到"团队周会"(周期日程,repeat_rule.is_repeat=true)
→ 不调用 cancel → 告知:目前暂不支持取消周期日程,请在企业微信客户端对该日程进行取消操作
```
### 3. 取消非本人创建的日程
不预先按"是否本人创建"拦截,取消前复述主题与时间并获确认,根据返回结果判断。
```
用户:帮我取消明天张三约的评审
→ 搜索 / get → 找到日程(创建人是张三)
→ 不提前拒绝 → 复述主题与时间并获用户确认后调用 cancel(schedule_id)
→ 依返回判断:
· 返回 {} → 报告:已取消
· 返回权限错误 → 告知:你无权取消该日程,建议联系创建人张三操作
```
## 注意事项
- **权限判定交给接口**:不预先按"是否本人创建"限制取消——获确认后执行 `cancel`(见上「取消前确认」),能否取消根据返回结果判断:返回空对象 `{}` 即取消成功;返回权限类错误则说明当前用户无权取消该日程,告知用户并建议联系创建人操作。
- **取消前确认**:取消日程前复述主题与时间并获确认;参数就绪后执行。
- **周期日程不支持取消**:检测到目标日程 `repeat_rule.is_repeat=true` 时,直接告知用户目前暂不支持取消周期日程,引导其在企业微信客户端操作,禁止改为整系列直接 cancel 等变通方式(详见 [SKILL.md 已知限制](../SKILL.md))。
- **"取消……改约到……"是改期、不是取消**:同时出现"取消"和"改到/改约/挪到/顺延"时本质是改期,按 SKILL.md「改约 / 重建日程前必须先识别会议关联」走更新流程,禁止拆成 cancel + create(目标 `meeting` 非空时,cancel + create 会丢失会议链接)。仅用户明确"不办了/不要了/直接取消"且无改期诉求时才执行 cancel。
- **关联在线会议的日程不在此取消**:若目标 `meeting` 非空(`search`/`list` 结果即可判定,无需补 `get`;或同一场在会议和日程两边都命中),改用 `读取 wecomcli-meeting 技能` 走 `meeting cancel`,会议取消后该日程会被一并取消,禁止在此对其调用 `schedule cancel`。
- **禁止暴露 userid**:结果展示中参与人只显示人名。
## 参考
- [wecomcli-calendar](../SKILL.md) — 日程技能主文档
- [calendar-search](calendar-search.md) — 搜索日程(用于定位目标日程)
- [calendar-agenda](calendar-agenda.md) — 查看日程安排
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible. | Stars: 119k | Updated | Claude CodeCodex | Verified | Install |
| screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe. | Stars: 118k | Updated | Claude CodeCodex | Verified | Install |
| contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies. | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |
| meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要". | Stars: 108k | Updated | Claude CodeCodex | Verified | Install |