Dingtalk Todo

钉钉待办 Skill

执行契约

• 执行第一个 dws 操作前完整读取 dingtalk-shared；当前任务已加载则不重复读取。
• 先把请求拆成有序步骤，再逐步选入口。已知命令直接执行，不先查 Help、Schema 或 Shortcut Catalog；只有当前 leaf 的 flag 或安全语义确实不明时才查精确 leaf。
• 所有命令加 --format json，按结构化业务返回判断结果。后续 ID 只取自本次真实返回；零匹配、多匹配或类型不明时停止并消歧。
• 写操作遵循最终 Runtime gate。需要确认时先说明对象、动作和影响，用户确认后才追加 --yes；不要把 --yes 写入存储示例。
• 写后必须核验。非幂等写超时、缺少稳定 ID 或读回失败时先查询对账，禁止盲目重放。

<!-- VISIBLE_SHORTCUTS_START -->

Shortcuts（无专用脚本/recipe 时优先）

以下 shortcut 同时进入公开 catalog 与 Runtime Schema。按本 skill/recipe 路由，命中时 Shortcut 优先于原子命令。参数只查 dws schema --cli-path "todo +<shortcut>" --compact --jq '{cli_path,parameters,constraints,confirmation}' -f json；仅需且已发布 result 时查 --jq '{cli_path,outcomes:.result.outcomes,pagination}'，字段级再查 data_schema；缺失不以 Help/样例推断。Schema 不可用才读一次已知 leaf Help；unknown flag 用同 leaf Help 修正一次。unknown command 禁 Help：错误 suggestion → 已加载 Skill/reference 明确入口；均无则报漂移。禁全 Catalog/root/parent/product Help；仅映射、接口或 provenance 审计省略 --compact。现有路由和 reference 均无法定位低频能力时，才用 dws shortcut list --service todo --format json 发现。

路由优先级

上面的通用 Shortcut 优先规则只适用于一个 Shortcut 完整覆盖当前步骤的情况。不要因为请求里出现“创建”就默认使用 +remind / +create。

1. 先选创建入口：按姓名指派用 +assign / +assign-multi；给自己记一条且后续只有搜索、详情或清理时用 +remind；已有真实 userId 且只需创建、回读和清理时用 +create。
2. 组合生命周期从原子创建开始：创建后还要按状态/优先级/角色/日期/页码列举，或继续更新、完成/重开、提醒、评论、附件、成员、子待办、标签，或一次创建多个对象时，使用 todo task create。不要用创建 Shortcut 代替第一步。
3. 后续按步骤选最窄入口：聚合、搜索和核验完整由 Shortcut 覆盖时使用 +get-my-tasks、+get-related-tasks、+due-today、+overdue、+search、+get、+complete、+reopen、+update、+comment、+reminder 或 +list-*；需要原子特有参数、动态子资源 ID、多对象或中间状态时用原子命令。
4. 确定性批量/汇总使用脚本：批量创建、今天/明天/本周汇总、逾期扫描分别使用 bundled script。
5. 跨步骤只传稳定 ID：Shortcut 与原子命令可以共存，但只传递规范化后的 taskId、commentId、attachmentId、tagCode、userId；不要假设两类入口的完整返回结构相同。

Golden Routes

低频原子能力

组合请求先读 组合生命周期。以下常用原子命令已审定，直接执行，不要先猜别名或查 Help：

删除类操作必须由用户确认；若用户在当前请求中已明确授权“办完后删除/清理本次创建对象”，该授权只覆盖本次记录的精确 ID。附件上传会真实传输本地文件，不能用来试探权限。

关键约束

• 标题、URL、展示序号都不是 taskId。已知 ID 直接行动；未知 ID 用列表/搜索定位，零匹配或多匹配时停止。
• 待办公开命令统一使用 --task-id；--id / --ids 只是隐藏兼容别名，不要写入新命令或示例。
• 优先级：低=10、普通=20、较高/高/重要=30、紧急/最高/P0=40。
• --due / +remind --at 表示 deadline；独立 reminder 必须走 +reminder。
• 自定义时间提醒的原子 flag 是 --reminder-time-stamp；不要把 Shortcut 的 --at 套到 task add-reminder。
• task list 使用 --status，不要写 --done；详情是 task get，不存在 task detail。
• “待办标签”始终属于 Todo，使用 dws todo tag ...；绝不能解释成 Git tag、通讯录标签或其他产品标签。
• 创建和评论是非幂等写。超时、缺少稳定 ID 或读回失败时保留“可能已提交/未核验”状态，先查询对账，禁止盲目重放。
• 所有命令加 --format json；写 Shortcut 按 Runtime 安全契约确认，确认前不得自行附加 --yes。
• 会后行动项来自听记时先走 dingtalk-minutes；OA 审批走 dingtalk-misc；时间块和会议走 dingtalk-calendar。

按需参考

• 局部意图消歧
• 轻量流程
• 组合流程
• 完整命令参考