用途
wecom-get-todo-detail 是企业微信待办场景中的详情查询技能，用于根据待办 ID 列表批量获取待办的完整信息（包含待办内容和分派人）。当用户表达“看看这个待办的详情”“待办内容是什么”“这个待办分派给谁了”“告诉我待办的具体信息”等需要查看待办完整内容的需求时使用。
主要能力
- 通过 wecom_mcp tool 调用
wecom_mcp call todo get_todo_detail '<json格式的入参>'，按待办 ID 列表批量查询详情。 - 单次最多传入 20 个待办 ID，超过需要分批请求。
- 返回内容涵盖：待办 ID、待办状态、待办内容、分派人列表（含分派人 ID、分派人状态、状态更新时间）、创建人 ID、当前用户状态、提醒时间、创建时间、更新时间。
- 支持将返回结果中的 follower_id 和 creator_id 通过通讯录匹配转为真实姓名后展示。
- 遭遇“返回 HTTP 错误”或“HTTP 请求失败”时，会主动重试，最多重试三次。
使用方式
前置条件：首次调用 wecom_mcp 前，必须按 wecom-preflight 技能执行前置条件检查，确保工具已加入白名单。
参数说明：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| todo_id_list | array | ✅ | 待办 ID 列表，最多 20 个 |
调用示例：
使用 wecom_mcp tool 调用 wecom_mcp call todo get_todo_detail '{"todo_id_list": ["TODO_ID_1", "TODO_ID_2"]}'
人员 ID 转姓名是展示可读结果的关键步骤：返回结果中的 follower_id 和 creator_id 都是系统内部 ID，用户只认识姓名。展示前需使用 wecom_mcp tool 调用 wecom_mcp call contact get_userlist '{}' 获取通讯录，在返回的 userlist 中用 userid 字段匹配 follower_id / creator_id，取对应的 name。若通讯录中找不到某个 ID，展示时标注“未知用户(ID: xxx)”。
todo_id 来源规则：todo_id 必须来自 wecom-get-todo-list 返回的结果，禁止自行推测或构造；用户通常提供待办内容描述而非 ID，应先通过 wecom-get-todo-list 查列表再匹配。
返回格式与字段说明
{
"errcode": 0,
"errmsg": "ok",
"data_list": [
{
"todo_id": "TODO_ID",
"todo_status": 1,
"content": "完成Q2规划文档",
"follower_list": {
"followers": [
{
"follower_id": "FOLLOWER_ID",
"follower_status": 1,
"update_time": "2025-01-16 14:20:00"
}
]
},
"creator_id": "CREATOR_ID",
"user_status": 1,
"remind_time": "2025-06-01 09:00:00",
"create_time": "2025-01-15 10:30:00",
"update_time": "2025-01-16 14:20:00"
}
]
}
| 字段 | 类型 | 说明 |
|---|---|---|
| data_list | array | 待办详情列表，最多 20 条 |
| data_list[].todo_id | string | 待办 ID |
| data_list[].todo_status | number | 待办状态：0-已完成，1-进行中，2-已删除 |
| data_list[].content | string | 待办内容 |
| data_list[].follower_list.followers | array | 分派人列表 |
| data_list[].follower_list.followers[].follower_id | string | 分派人 ID（即 userid）— 展示前需通过 wecom-contact-lookup 转为姓名 |
| data_list[].follower_list.followers[].follower_status | number | 分派人状态：0-拒绝，1-接受，2-已完成 |
| data_list[].follower_list.followers[].update_time | string | 分派人状态更新时间 |
| data_list[].creator_id | string | 创建人 ID — 展示前需通过 wecom-contact-lookup 转为姓名 |
| data_list[].user_status | number | 当前用户状态 |
| data_list[].remind_time | string | 提醒时间 |
| data_list[].create_time | string | 创建时间 |
| data_list[].update_time | string | 更新时间 |
典型工作流
列表 + 详情联合查询（三步缺一不可）：
- 通过 wecom-get-todo-list 获取待办列表，使用 wecom_mcp tool 调用
wecom_mcp call todo get_todo_list '{}'。 - 根据返回的 todo_id 批量获取详情，使用 wecom_mcp tool 调用
wecom_mcp call todo get_todo_detail '{"todo_id_list": ["TODO_ID_1", "TODO_ID_2", "TODO_ID_3"]}'。 - 通过 wecom-contact-lookup 获取通讯录，将 follower_id / creator_id 转为姓名，用返回的 userlist 中的 userid 匹配 follower_id 和 creator_id，取 name 字段作为展示姓名。
展示格式示例（分派人和创建人必须显示为姓名，不是 ID）：
📋 您当前的待办事项（共 3 项）
1. 🔵 完成Q2规划文档
- 待办状态：进行中 | 我的状态：已接受
- 提醒时间：2025-06-01 09:00
- 分派人：张三、李四
- 创建时间：2025-01-15
2. 🔵 提交周报
- 待办状态：进行中 | 我的状态：已接受
- 提醒时间：2025-03-17 18:00
- 创建时间：2025-03-10
3. ☑️ 代码评审
- 待办状态：已完成 | 我的状态：已完成
- 创建时间：2025-03-01
适用场景
- 用户需要查看某个待办的详细内容。
- 用户想知道待办分派给了谁、由谁创建。
- 用户希望了解待办的完整状态信息（待办状态、提醒时间、创建与更新时间等）。
- 与 wecom-get-todo-list 配合，实现“先列列表、再查详情”的完整查询流程。
限制与注意事项
- 前置条件：首次调用 wecom_mcp 前必须按 wecom-preflight 技能执行前置条件检查，确保工具已加入白名单。
- 单次上限：todo_id_list 最多传 20 个 ID，超过需要分批请求。
- todo_id 必须来自 wecom-get-todo-list 返回结果，禁止自行推测或构造。
- 人员 ID 必须转姓名：返回结果中的 follower_id 和 creator_id 是系统内部标识，展示待办详情前需通过通讯录匹配替换为姓名。
- 状态值含义：待办状态（todo_status）0-已完成、1-进行中、2-已删除；用户状态（user_status）0-拒绝、1-接受、2-已完成；分派人状态（follower_status）0-拒绝、1-接受、2-已完成。
- 错误处理：若 errcode 不为 0，告知用户 errmsg 中的错误信息。
- 重试策略：遭遇“返回 HTTP 错误”或“HTTP 请求失败”时主动重试，最多三次。
暂未提供的信息
该技能的具体收费、价格与平台支持范围等资料暂未提供。