企业微信待办

要解决什么问题

在企业微信里，待办往往分散在客户端里；如果你已经在用 wecom-cli 做自动化或让 Agent 代操作，就需要一套可脚本化的待办 API 语义：能按时间筛列表、看到「要做什么」而不只是一串 ID，还能创建、改提醒、分派同事、标记完成或删除。

技能如何工作

本技能通过执行 wecom-cli 子命令完成全部操作，核心能力包括：

• get_todo_list：按创建/提醒时间过滤，支持 cursor 分页；返回的是概要（todo_id、状态、时间等），不含正文与分派人。
• get_todo_detail：用 ID 批量拉详情（单次最多 20 个），拿到 content 与 follower_list。
• create_todo / update_todo / delete_todo：创建、全量替换分派人并更新内容与提醒时间，或删除（不可撤销）。
• change_todo_user_status：改当前用户在该待办上的状态（拒绝 / 接受 / 已完成）。

Agent 侧有两条硬约束，否则结果对用户不可用：

1. 列表后必须查详情——用户关心的是待办内容，不是 ID 列表。
2. creator_id / follower_id 必须先经 wecomcli-contact 通讯录转成姓名；找不到则标注「未知用户(ID：xxx)」。

创建或更新分派人时，follower_id 必须来自通讯录的 userid，禁止按姓名猜 ID；todo_id 只能来自列表查询结果，用户用描述指代时要先列表再匹配，多候选需让用户确认。

边界与注意点

• 分页：若 has_more 为 true，展示当前页的同时应说明还有更多，并询问是否继续。
• 状态语义：todo_status（待办整体）与 user_status / follower_status（个人或分派人）不同；「标记完成」要区分改整体待办还是只改自己的状态。
• update_todo 的 follower_list 是全量替换，追加分派人需先查现有列表再合并提交。
• HTTP 类失败可按技能策略重试，最多三次；errcode 非 0 时向用户说明 errmsg。