SuperAPI AI 工具集

dingtalk-todo

办公与效率

查看项目

更新于 10-15 21:33

技能介绍

用途:在命令行中管理钉钉待办事项,命令前缀为 dws todo,所有命令建议加 --format json 并按结构化返回判断结果。执行首个 dws 操作前需读取 dingtalk-shared。

主要能力(Shortcut):创建类 +create、+remind、+assign(按姓名指派)、+assign-multi(一次指派多人)、+update、+comment、+reminder(设置或清除提醒)、+todo-done(按标题关键词标完成,仅唯一命中时写入);查询类 +get、+get-my-tasks、+get-related-tasks、+due-today、+overdue、+search、+created-todos、+list-comment、+list-sub、+list-attachment。原子命令包括 todo task create/create-sub/list/get/update/done/delete、执行人与参与人增删、评论增删查、附件上传删除、提醒与标签管理。

用法要点:先拆解为有序步骤再选入口;已知命令直接执行,flag 语义不明才查精确 leaf Schema。创建组合流程从原子 todo task create 起步,返回 result.taskId 后再进入后续步骤,只传稳定 ID(taskId、commentId、attachmentId、tagCode、userId)。按姓名指派需姓名唯一解析后才写入。批量创建用 python scripts/todo_batch_create.py <todos.json> --dry-run 预览并提交同一 planDigest;今日/明日/本周汇总用 python scripts/todo_daily_summary.py today|tomorrow|week。

限制与约束:标题、URL、序号都不是 taskId,未知 ID 需经列表或搜索定位,零匹配或多匹配须停止消歧。优先级低=10、普通=20、较高=30、紧急=40;--due 与 +remind --at 表示截止时间而非提醒时间。写操作需按 Runtime 确认后追加 --yes,写后必须读回核验;创建与评论为非幂等写,超时或缺 ID 时先查询对账,禁止盲目重放。删除需用户确认。上游无提醒查询接口,reminder 仅返回终端回执且 verified=false。会后行动项、审批、日程分别走其他 Skill。