| name | dingtalk-todo |
| description | 钉钉待办 / TODO。Use when 用户说 创建待办/TODO/任务提醒/指派任务/标记完成/查待办/紧急待办/循环待办/批量建待办/逾期待办。Distinct from dingtalk-report(日报周报)、dingtalk-oa(审批)、dingtalk-calendar(日程)。命令前缀：dws todo。 |
| cli_version | >=0.2.14 |
| metadata | {"category":"product","stability":"experimental","requires":{"bins":["dws"]}} |
钉钉待办 Skill
🧪 EXPERIMENTAL · 试验版 / Preview — multi 模式当前未达 stable 标准。全部 dingtalk-* skill 已通过 dispatch verifier，但接口、命名、跨 skill 引用后续可能调整；生产 / 共享环境请优先使用 mono 模式（dws skill setup --mode mono）。问题请提 issue 反馈。
PREREQUISITE: Read the dws-shared skill first for auth, global flags, product routing, URL preflight, error codes, and safety rules. The dws binary must be on PATH.
⚠️ 命令可用性以当前 dws 二进制为准。服务发现已下线，本文档随内置 skill 发布；如果 dws <cmd> --help 不存在，说明当前版本未暴露该命令。若命令存在但调用失败，请按错误中的 endpoint 或 tool 提示确认静态端点目录和后端工具注册。实际调用前可用 dws <cmd> --help 或 --dry-run 验证。
命令参考：todo.md；剧本：02-task.md。
Shortcuts（无专用脚本/recipe 时优先）
以下 shortcut 来自独立于 Runtime Schema 的公开 catalog。先按本 skill 的意图表、脚本和 recipe 路由：存在精确覆盖该场景的专用脚本/recipe 时按其执行；否则用户意图命中时，shortcut 优先于手写原子命令。用 dws shortcut list --service todo --format json 读取参数、约束、风险和示例，并以 dws todo <shortcut> --help 核对当前 Cobra flags；不要对 + 路径调用 dws schema。
| Shortcut | 风险 | 适用场景 |
|---|
dws todo +assign | write | 按姓名给某人创建并指派一条待办（自动解析 userId） |
dws todo +assign-multi | write | 把一条待办按姓名一次性指派给多个人（自动把每个姓名解析成 userId） |
dws todo +created-todos | read | 列出我创建的待办（我作为创建人 creator 发起的待办，而非分配给我执行的） |
dws todo +get | read | 查询待办详情 |
dws todo +get-my-tasks | read | 查询当前组织下我的待办列表 |
dws todo +list-attachment | read | 查询待办任务的附件列表 |
dws todo +list-comment | read | 查询待办评论列表 |
dws todo +list-sub | read | 查询子待办列表 |
dws todo +overdue | read | 列出我已过期未完成的待办 |
dws todo +remind | write | 给自己创建一条带截止/提醒时间的待办 |
dws todo +todo-done | write | 按标题关键词把我的某条待办标记完成（自动定位 taskId） |
意图表
| 用户说 | 命令 |
|---|
| "建一条待办给张三" | dws todo task create --title "<标题>" --executors <userId> |
| "较高 / 高优先级待办" | dws todo task create ... --priority 30（10低/20普通/30较高/40紧急） |
| "紧急 / 最高优先级 / 立即处理" | dws todo task create ... --priority 40 |
| "循环待办（每天）" | dws todo task create ... --due "<首次截止ISO>" --recurrence "DTSTART:<UTC>\nRRULE:FREQ=DAILY;INTERVAL=1" |
| "批量建待办（JSON 文件）" | python scripts/todo_batch_create.py todos.json |
| "今天 / 本周未完成待办" | python scripts/todo_daily_summary.py [today|tomorrow|week] |
| "逾期待办" | python scripts/todo_overdue_check.py |
| "标记完成 / 重开" | dws todo task done --task-id <taskId> --status true|false |
| "修改标题/截止时间/优先级" | dws todo task update --task-id <taskId> ... |
| "删除待办" | dws todo task delete --task-id <taskId>（需用户确认） |
参数硬约束
- 任务详情只用
dws todo task get --task-id <taskId>；不要写 task detail。
- 完成状态首选
dws todo task done --task-id <taskId> --status true|false；若用 update，也必须是 --task-id + --done true|false。
- 查询列表完成状态用
dws todo task list --status false|true --format json。不要写 --done true 作为可见参数，虽然兼容但不作为推荐写法。
--id / --ids 是隐藏兼容别名，文档和生成命令统一写 --task-id，减少模型漂移。- 优先级映射：低=10，普通=20，较高/高/重要=30，紧急/最高/P0/马上处理=40；不要把"较高"写成 40。
- 截止时间必须是 ISO-8601。相对日期按当前日期计算；例如周五说"下周二"就是紧接下一个自然周的周二，不要再加一周。
- 附件命令
task add-attachment / list-attachment / remove-attachment 均可用：add-attachment --task-id <taskId> --file-path <本地文件>（真实上传，先确认待办存在，返回 result.attachmentIds）；list-attachment --task-id <taskId>（返回顶层 attachments[].attachmentId）；remove-attachment --task-id <taskId> --attachment-id <id> --yes（不可逆，先确认）。
- 创建、标记完成、重开、删除后必须
task get 或对应 task list --status ... 验证，不要只凭创建返回或口头计划结束。
- 所有 dws 命令带
--format json。
跨产品协作
- 执行人是人名 → 先用
dingtalk-aisearch 拿 userId
- 会后从听记自动建待办 → 切到
dingtalk-minutes
- 项目进度汇总写文档 → 切到
dingtalk-doc
