market/agents/wecom-assistant/docs/07-待办.md

待办

把「这件事要做」记进企业微信待办：记一条、查一批、改内容、标完成、删掉或退出。 可以只给自己记，也可以分派给同事并设截止时间与提醒。 这是整套能力里实测覆盖最完整的一域——6 个方法全部在真实账号上跑通了。

你可以怎么说

「帮我记个待办：明天下午三点前把周报发出去」 「我有哪些待办？」 「已完成的待办给我看看」 「把『准备周会材料』这条改一下截止时间，改到周五」 「这条待办完成了」 「把张三也加进这条待办」

📋 验证状态

项	状态
创建待办	✅ 已实测
查待办列表	✅ 已实测
查待办详情	✅ 已实测
更新待办（改标题）	✅ 已实测
标记完成	✅ 已实测（高风险写入）
删除待办	✅ 已实测（高风险写入）
分派给他人（多人参与）	⚠️ 未实测（实测账号只有一个人）
完整链路（你说一句话 → 助手自动记完）	⚠️ 未实测

实测记录（命令层，人工在真实账号上执行，6/6 全通）：

动作	结果
创建	✅ 成功。创建人显示的是机器人身份，不是你本人——这一点直接决定了后面能改什么
列表 / 详情 / 更新	✅ 全通，标题改名成功
标记完成	✅ 企业微信反问了一句「是否标记为已全部完成」，这个选择被原样交回
删除	✅ 删除后复核，待办数量归 0

还实测证实了一个隐蔽的坑：不传待办条目会直接失败，返回「items 不合法，要求为 必填」。 而工具的帮助文本没有把它标成必填——助手知道这一点，不会拿空请求去试。

测试数据已全部删除，企业微信侧复核数量为 0。

能力清单

能做什么	命令	风险
查待办列表（按时间 / 状态 / 关键词筛）	wecom-cli todo list	读取
批量查待办详情	wecom-cli todo get	读取
创建待办	wecom-cli todo create	低风险写入（分派给他人时升为高风险）
更新待办	wecom-cli todo update	低风险写入（改参与人时升为高风险）
标记完成	wecom-cli todo finish	高风险写入
删除 / 退出待办	wecom-cli todo delete	高风险写入

只给自己记一条，助手直接执行，不问你。 过度确认会让助手变得难用。 只有下面这些情况才会先问一句：

情况	为什么要问
分派给他人	对方待办列表里立刻出现这条，还会收到提醒
改参与人名单	是「整体替换」不是「追加」，漏掉谁就等于把谁踢出这条待办
标记完成	没有「取消完成」这个操作，标完就只能去客户端处理
删除	没有恢复接口

注意事项

「完成」是单向的。 接口层根本没有「取消完成」这个方法。所以标完成前助手会先确认， 而且会先检查一遍这条是不是已经完成了——已完成就直接告诉你「这条已完成」，不再重复操作。

完成范围可能有两档。 一条待办有多个参与人、而你既是创建人又是参与人时， 标完成会先只标你自己那份，然后企业微信会反问一句是否连别人的份一起标。 助手会把这个选择带着待办标题和参与人姓名交回给你，让你选「仅我完成」还是「已完全完成」—— 不会替你决定（实测中确实触发了这个反问）。

「删除」对不同的人是两件事。

你的身份	「删除」的实际含义
你是这条待办的创建人	删掉整条，其他参与人也不再看到
你不是创建人	你退出这条待办，不影响其他人

助手会先弄清是哪一种，再用对应的话跟你确认。它不会用「创建人之外无权删除」这种话搪塞你—— 非创建人本来就可以退出。

改参与人是「整体替换」，这是本域最危险的一个动作。 说「把张三也加进去」时，助手会先把现有名单读出来，本地合并成完整名单，再整份传回去。 它不会只传张三一个人——那样会把原来的人全部踢出去。这也是为什么改参与人要先确认。

顺带一提：说「分派给我和张三」时，你自己也要在名单里——企业微信不会自动把创建人算成参与人。 助手知道这一点。

查询默认只给「进行中」。 问「我有哪些待办」返回的是进行中的； 要看已完成的、或者全部，得说清楚（「已完成的待办」「所有待办」）。 助手在做删除、完成这类操作前定位待办时，会主动把已完成的也查进来，免得「其实有」被误判成「找不到」。

关键词是字面匹配，不是语义搜索。 你记的是「把周报发出去」，搜「汇报」是搜不到的。 搜不到时助手会建议放宽关键词或改按时间范围列，不会断言「你没有这条待办」。

统计类问题它会翻完所有页。 「我一共有多少条待办」这种问题，单页最多只能拿 20 条， 只看首页会严重少算——助手会翻到底再报数。

截止时间和提醒有几条固定规则：

• 你说了具体时刻（「明天下午三点前」）→ 落成精确到分钟的截止时间。
• 你只给了日期（「周五之前」）→ 落成日期。
• 你完全没提时间 → 两个都不设，它不会追问。
• 「不要提醒我」做不到：接口层没有「关闭提醒」这一档。唯一的办法是把截止时间一起清掉， 助手会先跟你确认再动手。
• 「提前 30 分钟提醒」也设不了：只能设截止时间，提醒时刻由企业微信按默认规则给。 助手会告诉你实际的提醒时刻，并引导你去企业微信待办里手动改。
• 它不会另建一个定时任务来模拟提醒——那会造成重复提醒。

描述不会写成标题的复述。 只有标题装不下的额外信息（背景、对接人、单号、链接）才会写进描述。 一条只有标题的待办完全正常。

「帮我记一下」不一定是待办。 只有你明确说了「待办」，或者说的是「定时提醒的待办」， 助手才会建企业微信待办。泛泛的「提醒我一下」它不会擅自往待办里塞——那可能该用日程， 也可能该用别的方式。

三条通用边界在本域怎么体现

1. 只能改它自己建的东西——实测确认：助手创建的待办，创建人是机器人身份。 这意味着你自己在企业微信里建的待办，助手改不了、也标不了完成。 碰到这种请求，它会说明边界，并建议由它新建一条，或者你在客户端自己改。
2. 能力按品类逐项开通——待办属于基础品类，实测账号一开始就能用。 未开通时助手会把官方开通指引原样转给你，然后停下，不重试。
3. 危险动作先问你——完成、删除总是先问；分派给他人、改参与人名单按参数升级为先问； 只给自己记一条不问。见 99 风险与确认。

相关

• 02 通讯录——分派给同事前先在这里把人名解析出来
• 05 日程——「占一段时间」而不是「记一件事」时用它
• 06 会议——会议纪要里的行动项可以落成待办
• 99 风险与确认——哪些待办操作会先问你、判定规则是什么