SuperAPI AI 工具集

wecomcli-todo

办公与效率

查看项目

更新于 10-16 10:25

技能介绍

wecomcli-todo 用于通过 wecom-cli 工具管理企业微信待办。它并非终端命令,所有操作都通过调用该 tool 完成,参数应使用 args 传入,禁止通过 exec / shell / 终端等命令行方式使用。

一、前置条件 首次调用 wecom-cli 前,必须按 wecomcli-preflight 技能执行前置条件检查,确保工具已加入白名单。

二、查询与定位 查询范围仅限企业微信待办系统中已经存在的记录。可按创建时间、截止时间、完成状态和标题/描述关键词查询;关键词是字面匹配,不是语义搜索。当用户问“我有哪些待办”“未完成待办有哪些”或“接下来有哪些待办”时,使用 todo list 查询待办系统中的记录。删除、完成或更新时,若上下文没有 todo_id,先用 todo list 定位;已有 todo_id 且需要确认最新详情或状态时,使用 todo get。

三、接口路由表 执行任何操作前,必须先定位「接口路由表」指向的参考文档并完整读取,再执行命令,避免出现参数错误。严禁凭路由表描述或自身记忆猜测拼参数。 用户意图与参考位置对应如下:创建待办(可选分派)见 references/todo-create.md;删除待办 / 退出待办 / 从我的待办中移除见 references/todo-delete.md;完成当前用户自己的部分 / 将整条待办全部完成见 references/todo-finish.md;已有 todo_id 时确认待办详情和最新状态见 references/todo-get.md;查看待办列表、按创建时间/截止时间/完成状态或关键词筛选、为后续操作定位待办见 references/todo-list.md;修改待办内容 / 分派人名单 / 截止时间(不含参与人状态)见 references/todo-update.md。

四、deadline 对象规范 待办的截止时间统一以 deadline 对象表达,涉及“设置截止时间”“修改截止时间”“清空截止时间”或读取待办截止信息时按此规范处理。结构上包含 type 与 value 两个字段:type 为 string、必填,枚举值 date(仅日期,如果用户没有提及具体时分秒,则一定选择 date)/ datetime(用户提及了具体时刻);value 为 string、必填,type=date 时格式为 YYYY-MM-DD,type=datetime 时格式为 YYYY-MM-DD HH:mm:ss。 在 deadline / remind_at_deadline 字段上的语义:设置或修改 deadline 整体可选,若提供则其内部 type 与 value 必填;清空已设置的截止时间时将 deadline 字段更新为空对象 {},不更新该字段则保持原值不变;作为返回字段时,未设置截止时间的待办 deadline 字段不返回或为 null。

五、提醒时机(remind_at_deadline) remind_at_deadline 与 deadline 是一对,必须一起出现——脱离 deadline 单独传 remind_at_deadline 不会生效,不要这么传。remind_at_deadline 只决定提醒时机,入参层面没有“关闭提醒”这一档(是否真正提醒由后台判断,可能因不满足条件而不提醒,以返回的 extra_info 为准):remind_at_deadline=true(仅 deadline.type=datetime 可传)表示在截止时刻提醒;remind_at_deadline=false 或不传表示按后台默认的提前时间提醒(不是关闭提醒)。deadline.type=date 或未传 deadline 时不要传 true。

六、从用户输入推断 deadline 日期/星期直接限定待办中的任务或事件时,也视为截止日期。例如“周三开会要带笔记本”应将周三写入 deadline。待办提醒时间等于截止时间:明确要“定时提醒的待办 / 到某时提醒的待办 / 待办提醒”且给出具体时刻时,用户预期提醒时间落为 deadline.type=datetime,并传 remind_at_deadline=true;只给日期或未给提醒/截止时间时不追问,不传 remind_at_deadline=true。普通截止时间:只说截止/到期时间,或给出任务发生日期时,仅填写 deadline、不传 remind_at_deadline,此时按后台默认提前时间提醒。时间格式:具体截止/提醒时刻用 deadline.type=datetime、value="YYYY-MM-DD HH:mm:ss";只有截止日期用 type=date、value="YYYY-MM-DD"。未提截止/提醒或任务发生时间时,deadline 整体不传,remind_at_deadline 也不传,不追问。 对于“xx 时间截止,并提前 yy 提醒”:deadline 永远填用户说的 xx 截止时间,不要填提前后的提醒时间;当前入参不能直接设置“提前 yy”,创建/更新后用返回的 extra_info 判断系统提醒时间是否刚好满足 yy,不满足或无 extra_info 时回复:目前不支持直接创建您需要的提醒时间,已为您设置截止时间为 XX,请到企业微信待办功能中手动修改提醒时间(XX 填本次 deadline.value)。

deadline 示例:{ "type": "date", "value": "2026-05-08" } 与 { "type": "datetime", "value": "2026-05-08 09:00:00" }。

七、特别注意 禁止将 todo_id(待办 ID)展示给用户。