待办 (todo) 命令参考

命令总览

创建待办

Usage:
  dws todo task create [flags]
Example:
  dws todo task create --title "修复线上Bug" --executors <USER_ID_1>,<USER_ID_2> --priority 40
  dws todo task create --title "提交报告" --executors <USER_ID> --due "2026-03-20T10:00:00+08:00"
  dws todo task create --title "每日站会" --executors <USER_ID> \
    --due "2026-03-20T10:00:00+08:00" \
    --recurrence $'DTSTART:20260320T020000Z\nRRULE:FREQ=DAILY;INTERVAL=1'
Flags:
      --due string          截止时间 ISO-8601 (如 2026-03-10T18:00:00+08:00)
      --executors string    执行者 userId 列表 (必填)
      --priority string     优先级: 10低/20普通/30较高/40紧急
      --recurrence string   循环规则 RFC 5545 (DTSTART+RRULE，仅在同时设置 --due 时生效)
      --title string        待办标题 (必填)

查询待办列表

Usage:
  dws todo task list [flags]
Example:
  dws todo task list --page 1 --size 20 --status false
Flags:
      --page string     页码 (默认 1)
      --size string     每页数量 (默认 20)
      --status string   true=已完成, false=未完成

修改待办任务

Usage:
  dws todo task update [flags]
Example:
  dws todo task update --task-id <taskId> --title "新标题"
  dws todo task update --task-id <taskId> --priority 40 --due "2026-03-10T18:00:00+08:00"
  dws todo task update --task-id <taskId> --done true
Flags:
      --done string       完成状态: true/false
      --due string        截止时间 ISO-8601 (如 2026-03-10T18:00:00+08:00)
      --priority string   优先级: 10低/20普通/30较高/40紧急
      --task-id string    待办任务 ID (必填)
      --title string      新标题

修改执行者的待办完成状态

Usage:
  dws todo task done [flags]
Example:
  dws todo task done --task-id <taskId> --status true
  dws todo task done --task-id <taskId> --status false
Flags:
      --status string    完成状态: true=已完成, false=未完成 (必填)
      --task-id string   待办任务 ID (必填)

待办详情

Usage:
  dws todo task get [flags]
Example:
  dws todo task get --task-id <taskId>
Flags:
      --task-id string   待办任务 ID (必填)

删除待办

Usage:
  dws todo task delete [flags]
Example:
  dws todo task delete --task-id <taskId>
  dws todo task delete --task-id <taskId> --yes
Flags:
      --task-id string   待办任务 ID (必填)

意图判断

用户说"加个待办/记一下/TODO" → task create 用户说"看看待办/我有啥要做" → task list 用户说"改个待办/修改待办标题/改优先级" → task update 用户说"做完了/完成待办/标记完成" → task done 用户说"看看待办详情" → task get 用户说"删除待办/取消待办" → task delete

关键区分: todo(个人待办)

核心工作流

# 1. 创建待办 — 提取 todoTaskId
dws todo task create --title "修复线上Bug" --executors userId1,userId2 \
  --priority 40 --due "2026-03-10T18:00:00+08:00" --format json

# 2. 查看未完成待办
dws todo task list --page 1 --size 20 --status false --format json

# 3. 查看待办详情
dws todo task get --task-id <taskId> --format json

# 4. 修改待办信息
dws todo task update --task-id <taskId> --title "新标题" --priority 40 --format json

# 5. 标记待办完成
dws todo task done --task-id <taskId> --status true --format json

# 6. 删除待办
dws todo task delete --task-id <taskId> --yes --format json

上下文传递表

操作	从返回中提取	用于
`task create`	`todoTaskId`	update/done/get/delete 的 --task-id
`task list`	`result[].id`	update/done/get/delete 的 --task-id

注意事项

优先级值: 10=低, 20=普通, 30=较高, 40=紧急
--due 截止时间使用 ISO-8601 格式（如 2026-03-10T18:00:00+08:00）
--recurrence 为 RFC 5545 循环规则（DTSTART:...\nRRULE:FREQ=DAILY;INTERVAL=1 这种格式），必须与 --due 同时设置才生效
task list 的 --status 对应 MCP get_user_todos_in_current_org 的 todoStatus 参数
todo 是个人待办管理产品
task update 可同时修改标题/优先级/截止时间/完成状态
task done 专用于修改执行者的完成状态，与 task update --done 作用不同
task delete 为不可逆操作，建议加 --yes 并与用户确认

自动化脚本

脚本	场景	用法
todo_daily_summary.py	查看今天/明天/本周未完成待办汇总	`python todo_daily_summary.py today`
todo_batch_create.py	从 JSON 文件批量创建待办	`python todo_batch_create.py todos.json`
todo_overdue_check.py	扫描逾期待办输出逾期清单	`python todo_overdue_check.py`

4.8 KiB Raw Blame History Unescape Escape