按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。
企业微信待办管理
执行任何wecom-cli命令前,必须先读取并完成wecomcli-shared技能的公共前置检查。
使用 wecom-cli 管理企业微信待办。
查询与定位
- 查询范围仅限企业微信待办系统中已经存在的记录。
- 可按创建时间、截止时间、完成状态和标题/描述关键词查询;关键词是字面匹配,不是语义搜索。
- 用户问"我有哪些待办""未完成待办有哪些"或"接下来有哪些待办"时,使用
todo list查询待办系统中的记录。 - 删除、完成或更新时,若上下文没有
todo_id,先用todo list定位;已有todo_id且需要确认最新详情或状态时,使用todo get。
接口路由表
[重要事项] 执行任何操作前,必须先定位「接口路由表」指向的参考文档并完整读取,再执行命令,避免出现参数错误。严禁凭路由表描述或自身记忆猜测拼参数。
| 用户意图 | 参考位置 |
|---|---|
| 创建待办(可选分派) | references/todo-create.md |
| 删除待办 / 退出待办 / 从我的待办中移除 | references/todo-delete.md |
| 完成当前用户自己的部分 / 将整条待办全部完成 | references/todo-finish.md |
已有 todo_id 时确认待办详情和最新状态 | references/todo-get.md |
| 查看待办列表;按创建时间、截止时间、完成状态或关键词筛选;为后续操作定位待办 | references/todo-list.md |
| 修改待办内容 / 分派人名单 / 截止时间(不含参与人状态) | references/todo-update.md |
deadline 对象规范
待办的截止时间统一以 deadline 对象表达。涉及"设置截止时间"、"修改截止时间"、"清空截止时间"或读取待办的截止信息时,按本节规范处理。
结构
| 字段 | 类型 | 必填 | 语义 |
|---|---|---|---|
type | string | 是 | 枚举:date(仅日期,如果用户没有提及具体时分秒,则一定选择date) / datetime(用户提及了具体时刻) |
value | string | 是 | type=date 时格式 YYYY-MM-DD;type=datetime 时格式 YYYY-MM-DD HH:mm:ss |
在 deadline / remindatdeadline 字段上的语义
- 设置或修改 `deadline`:整体可选;若提供则其内部
type与value必填。 - 清空已设置的截止时间:将
deadline字段更新为空对象{};不更新该字段则保持原值不变。 - 作为返回字段:未设置截止时间的待办,
deadline字段不返回或为null。 - 提醒时机(`remind_at_deadline`):
remind_at_deadline与deadline是一对,必须一起出现——脱离deadline单独传remind_at_deadline不会生效,不要这么传。remind_at_deadline只决定提醒时机,入参层面没有"关闭提醒"这一档(是否真正提醒由后台判断,可能因不满足条件而不提醒,以返回的extra_info为准): remind_at_deadline=true(仅deadline.type=datetime可传)→ 在截止时刻提醒。remind_at_deadline=false或不传 → 按后台默认的提前时间提醒(不是关闭提醒)。deadline.type=date或未传deadline时不要传true。
从用户输入推断 deadline
日期/星期直接限定待办中的任务或事件时,也视为截止日期。例如"周三开会要带笔记本"应将周三写入 deadline。
- 待办提醒时间 = 截止时间:明确要"定时提醒的待办 / 到某时提醒的待办 / 待办提醒"且给出具体时刻时,用户预期提醒时间落为
deadline.type=datetime,并传remind_at_deadline=true;只给日期或未给提醒/截止时间时不追问,不传remind_at_deadline=true。 - 普通截止时间:只说截止/到期时间,或给出任务发生日期时,仅填写
deadline、不传remind_at_deadline;此时按后台默认提前时间提醒。 - 时间格式:具体截止/提醒时刻 →
deadline.type=datetime、value="YYYY-MM-DD HH:mm:ss";只有截止日期 →type=date、value="YYYY-MM-DD"。 - 未提截止/提醒或任务发生时间:
deadline整体不传,remind_at_deadline也不传,不追问。 - xx 时间截止,并提前 yy 提醒:
deadline永远填用户说的 xx 截止时间,不要填提前后的提醒时间。当前入参不能直接设置"提前 yy";创建/更新后用返回的extra_info判断系统提醒时间是否刚好满足 yy,不满足或无extra_info时回复:目前不支持直接创建您需要的提醒时间,已为您设置截止时间为 XX,请到企业微信待办功能中手动修改提醒时间。(XX 填本次deadline.value)
示例
{ "type": "date", "value": "2026-05-08" }
{ "type": "datetime", "value": "2026-05-08 09:00:00" }特别注意
- 禁止将
todo_id(待办 ID)展示给用户。

