---
name: qiwei-official-todo
description: 通过企业微信官方 CLI 搜索成员并创建、同步、更新、完成或删除由当前机器人创建的待办，维护参与人、截止时间、提醒和处理状态。适用于记待办、分配任务、查看机器人待办、催办、改截止时间、完成事项，以及在 4320 Dashboard 展示真实企微待办。
---

# 企业微信官方待办

## 前置检查

1. 调用 `qiwei_official_status`。
2. CLI 未安装时调用 `qiwei_official_prepare`。
3. 未初始化时停止业务调用，把初始化命令交给用户完成授权。
4. 调用 `qiwei_official_help` 读取 `todo` 类别的当前方法与参数，不猜测固定 schema。

## 创建待办

1. 把事项整理为明确的动词开头标题。
2. 确认负责人、截止时间、优先级、验收标准和来源。
3. 只有姓名时先通过官方通讯录匹配成员；同名必须确认。
4. 用户一次给出多个事项时，先展示结构化清单，经确认后批量创建。
5. 使用 `qiwei_official_call` 执行，并返回待办标题、负责人、截止时间和链接。

## 查询与推进

- 查询时按未完成、临期、逾期和已完成分组。
- 修改负责人、截止时间或状态前先读取当前值。
- 完成待办时记录完成说明或交付物链接。
- 删除待办必须明确确认；“完成”与“删除”不可混用。
- 从会议纪要提取待办时，与 `qiwei-goal-management` 配合：先提取并确认，再创建正式企微待办。

## Dashboard 工作流

在“知识库 → 企微官方待办中心 → 待办中心”中执行：

1. 先用 `search_todo_userid` 按姓名或别名查询参与人 userid，不猜测人员标识；
2. 用参与人 userid 调用 `get_todo_list`，单页最多 20 条；
3. 创建待办时明确内容、参与人、截止时间和提醒方式；
4. 完成待办时调用 `update_todo` 将 `todo_status` 设为 `0`，不把完成等同于删除；
5. 将真实结果写入 `outputs/knowledge/todos/`，不生成 Mock 待办。

官方边界：列表、详情、更新和删除只适用于当前机器人创建的待办。不要把其他来源任务伪装为企微官方待办。

## 与统一任务中心协同

- 内部成员任务在姓名能可靠解析为 userid 且用户确认后，才同步为真实企微官方待办；
- 外部联系人没有官方内部成员 userid，相关事项保留为本地客户跟进任务，并通过“转到智能会话”继续沟通；
- 客户任务绑定 `todo_id` 后只计为一项任务，完成本地任务时同步完成官方待办；
- 成员搜索失败或官方通道不可用时，不猜 userid，也不阻塞本地任务推进。