企业微信待办管理
执行任何
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 / remind_at_deadline 字段上的语义
- 设置或修改
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）
示例
json{ "type": "date", "value": "2026-05-08" } { "type": "datetime", "value": "2026-05-08 09:00:00" }
特别注意
- 禁止将
todo_id（待办 ID）展示给用户。
