用途
wecom-todo 是一个企业微信待办事项管理技能，用于通过 wecom_mcp 工具对企业微信中的待办进行查询、创建、更新、删除和状态变更操作。所有操作均通过调用 wecom_mcp tool 完成。
前置条件
首次调用 wecom_mcp 前，必须按 wecom-preflight 技能执行前置条件检查，确保工具已加入白名单。
主要能力
- 查询待办列表：按创建时间和提醒时间过滤，支持分页，返回待办概要信息
- 获取待办详情：根据待办 ID 列表批量获取完整信息（含内容和分派人）
- 创建待办：创建新的待办事项，可指定内容、分派人和提醒时间
- 更新待办：修改已有待办的内容、分派人、状态或提醒时间
- 删除待办：删除指定的待办事项
- 变更用户待办状态：更改当前用户在某个待办中的状态（拒绝/接受/已完成）
使用方式
统一调用格式：
wecom_mcp call todo <tool_name> '<json格式的入参>'
1. 查询待办列表（get_todo_list）
调用：wecom_mcp call todo get_todo_list '<json格式的入参>'
入参：create_begin_time、create_end_time、remind_begin_time、remind_end_time 均为可选，格式 YYYY-MM-DD HH:mm:ss；limit 可选，默认 10，最大 20；cursor 可选，首次请求不传，后续传入上次响应的 next_cursor。
返回包含 index_list（含 todo_id、todo_status、user_status、creator_id、remind_time、create_time、update_time）、next_cursor、has_more。列表返回的是概要信息，不含内容和分派人。
2. 获取待办详情（get_todo_detail）
调用：wecom_mcp call todo get_todo_detail '{"todo_id_list": ["TODO_ID_1", "TODO_ID_2"]}'
入参：todo_id_list 必填，最多 20 个。
返回 data_list，包含 todo_id、todo_status、content、follower_list.followers（follower_id、follower_status、update_time）、creator_id、user_status、remind_time、create_time、update_time。
3. 创建待办（create_todo）
调用示例：wecom_mcp call todo create_todo '{"content": "<待办的内容>", "remind_time": "2025-06-01 09:00:00"}'
入参：content 必填；follower_list 可选；remind_time 可选。返回 todo_id。
4. 更新待办（update_todo）
调用示例：wecom_mcp call todo update_todo '{"todo_id": "TODO_ID", "content": "<待办的内容>", "remind_time": "2025-07-01 09:00:00"}'
入参：todo_id 必填；content、follower_list、todo_status、remind_time 可选。follower_list 为全量替换，非追加；若要新增分派人，需先查出现有分派人，合并后一起提交。
5. 删除待办（delete_todo）
调用示例：wecom_mcp call todo delete_todo '{"todo_id": "TODO_ID"}'
入参：todo_id 必填。删除前必须向用户确认。delete_todo 与 update_todo 设置 todo_status=2 效果相同，优先使用 delete_todo。
6. 变更用户待办状态（change_todo_user_status）
调用示例：wecom_mcp call todo change_todo_user_status '{"todo_id": "TODO_ID", "user_status": 2}'
入参：todo_id、user_status 均必填；user_status 取值 0-拒绝，1-接受，2-已完成。
行为策略与限制
- 查完列表必须查详情：get_todo_list 只返回概要信息，需紧接着用 todo_id 调用 get_todo_detail 获取完整内容后再展示。
- 人员 ID 转姓名：follower_id 和 creator_id 为系统内部 ID，展示前需通过 wecom-contact 技能获取通讯录，用 userid 匹配取 name；找不到时标注“未知用户(ID: xxx)”。
- 分页提醒：has_more 为 true 时，必须提示用户“还有更多待办未显示”并询问是否继续查看。
- 重试策略：遇到“返回 HTTP 错误”或“HTTP 请求失败”时主动重试，最多三次。
- todo_id 必须来自 get_todo_list 返回结果，禁止自行推测或构造；用户描述内容时先查列表再匹配，多个相似待办需让用户确认。
- follower_id 即 userid，必须通过 wecom-contact 的 get_userlist 获取，禁止猜测；同名人员需展示候选让用户选择。
- 时间参数统一使用 YYYY-MM-DD HH:mm:ss 格式；相对时间根据当前日期推算。
- follower_list 输入格式为
{"followers": [{"follower_id": "FOLLOWER_ID", "follower_status": 1}]}。 - 破坏性操作确认：删除待办前必须确认；变更状态为“拒绝”前建议确认。
- 单次详情上限：todo_id_list 最多 20 个，超过需分批请求。
- 错误处理：errcode 不为 0 时，告知用户 errmsg 中的错误信息。
- 通讯录查询：涉及分派人时，先通过 wecom-contact 的 get_userlist 接口获取成员列表（无入参，返回含 userid、name、alias），再本地筛选匹配 userid。
典型工作流
- 查看待办列表：“看看我最近的待办”——get_todo_list → get_todo_detail → contact 转姓名，并检查 has_more。
- 按时间范围查询：传入 create_begin_time / create_end_time 过滤。
- 创建待办并分派：先通过 wecom-contact 查 userid，再 create_todo 带 follower_list。
- 标记完成：区分场景 A（改 todo_status=0）和场景 B（改 user_status=2）。
- 更新待办：先查列表与详情定位目标，再 update_todo。
- 删除待办：删除前必须确认，不可撤销。
- 分页获取：通过 cursor 循环拉取，未拉完必须提醒用户。
暂未提供的信息
关于该技能的具体收费、价格、可用版本、支持的企业微信账号类型与权限范围、部署与安装细节等，资料中暂未提供。