{
  "version": 1,
  "source": {
    "kind": "explicit",
    "name": "dws-agent-selection/todo",
    "repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
    "channel": "open-source",
    "reviewed": true
  },
  "tools": {
    "todo.add_task_executors": {
      "agent_summary": "添加待办执行人",
      "use_when": [
        "已知 taskId，需要为待办追加执行人（userId 列表）时"
      ],
      "avoid_when": [
        "要添加参与人时改用 dws todo task add-participant",
        "要上传附件时改用 dws todo task add-attachment",
        "待办或执行人未确认时不要添加"
      ],
      "examples": [
        "dws todo task add-executor --task-id <taskId> --executors <USER_ID_1>,<USER_ID_2>",
        "dws todo task add-executor --task-id <taskId> --executors userId1,userId2 --format json"
      ],
      "reviewed": true,
      "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.add_task_executors",
        "cobra-help:dws todo task add-executor",
        "Skill:skills/mono/references/products/todo.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#todo.add_task_executors",
        "live-dws-schema:todo.add_task_executors"
      ]
    },
    "todo.add_task_participants": {
      "agent_summary": "添加待办参与人",
      "use_when": [
        "已知 taskId，需要为待办追加参与人（userId 列表）时"
      ],
      "avoid_when": [
        "要添加执行人时改用 dws todo task add-executor",
        "要上传附件时改用 dws todo task add-attachment",
        "待办或参与人未确认时不要添加"
      ],
      "examples": [
        "dws todo task add-participant --task-id <taskId> --participants <USER_ID_1>,<USER_ID_2>",
        "dws todo task add-participant --task-id <taskId> --participants userId1,userId2 --format json"
      ],
      "reviewed": true,
      "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.add_task_participants",
        "cobra-help:dws todo task add-participant",
        "Skill:skills/mono/references/products/todo.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#todo.add_task_participants",
        "live-dws-schema:todo.add_task_participants"
      ]
    },
    "todo.add_todo_attachment": {
      "agent_summary": "上传待办附件",
      "use_when": [
        "已知 taskId 且待办已确认存在，需要上传本地文件为待办附件时"
      ],
      "avoid_when": [
        "待办尚未确认存在或仅试探调用时不要上传（会真实写附件）",
        "要添加执行人/参与人/提醒时改用对应 add 命令"
      ],
      "examples": [
        "dws todo task add-attachment --task-id <taskId> --file-path /path/to/file.pdf",
        "dws todo task add-attachment --task-id <taskId> --file-path /path/to/file.pdf --format json"
      ],
      "reviewed": true,
      "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.add_todo_attachment",
        "cobra-help:dws todo task add-attachment",
        "Skill:skills/mono/references/products/todo.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#todo.add_todo_attachment",
        "live-dws-schema:todo.add_todo_attachment"
      ]
    },
    "todo.add_todo_comment": {
      "agent_summary": "给待办添加评论",
      "use_when": [
        "已知 taskId，需要给待办新增一条评论文本时"
      ],
      "avoid_when": [
        "要删除评论时改用 dws todo comment delete",
        "要列出评论时改用 dws todo comment list"
      ],
      "examples": [
        "dws todo comment add --task-id <taskId> --content \"评论内容\"",
        "dws todo comment add --task-id <taskId> --content \"已开始处理\" --format json"
      ],
      "reviewed": true,
      "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.add_todo_comment",
        "cobra-help:dws todo comment add",
        "Skill:skills/mono/references/products/todo.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#todo.add_todo_comment",
        "live-dws-schema:todo.add_todo_comment"
      ]
    },
    "todo.add_todo_reminder": {
      "agent_summary": "写入一条待办提醒规则（上游不支持规则读回）",
      "use_when": [
        "已知 taskId，需要按截止时间偏移或自定义时间戳添加提醒时（dueTime 模式要求待办已有截止时间）；成功响应仅作为写入回执"
      ],
      "avoid_when": [
        "要重置/清除提醒规则时改用 dws todo task reset-reminder",
        "提醒时间与目标待办未确认时不要添加",
        "业务要求写后读取并核验 reminderRules 时不要声称可验证；当前 task get/list 均不返回提醒规则"
      ],
      "examples": [
        "dws todo task add-reminder --task-id <taskId> --base-time dueTime --due-date-offset -30",
        "dws todo task add-reminder --task-id <taskId> --base-time customTime --reminder-time-stamp \"2026-03-10T18:00:00+08:00\""
      ],
      "reviewed": true,
      "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.add_todo_reminder",
        "cobra-help:dws todo task add-reminder",
        "Skill:skills/mono/references/products/todo.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#todo.add_todo_reminder",
        "live-dws-schema:todo.add_todo_reminder"
      ]
    },
    "todo.create_personal_sub_todo": {
      "agent_summary": "创建个人子待办",
      "use_when": [
        "父待办由本人创建且已确认 parentId，需要创建子待办（标题、执行人、可选截止时间/优先级）时"
      ],
      "avoid_when": [
        "只需创建顶层待办时改用 dws todo task create",
        "父待办不是本人创建或 parentId 未确认时不要创建；子待办不支持独立循环规则"
      ],
      "examples": [
        "dws todo task create-sub --parent-id <PARENT_TASK_ID> --title \"子任务标题\" --executors <USER_ID_1>,<USER_ID_2> --priority 40",
        "dws todo task create-sub --parent-id <PARENT_TASK_ID> --title \"子任务标题\" --executors <USER_ID> --due \"2026-03-20T10:00:00+08:00\""
      ],
      "reviewed": true,
      "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.create_personal_sub_todo",
        "cobra-help:dws todo task create-sub",
        "Skill:skills/mono/references/products/todo.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#todo.create_personal_sub_todo",
        "live-dws-schema:todo.create_personal_sub_todo"
      ]
    },
    "todo.create_personal_todo": {
      "agent_summary": "创建个人待办",
      "use_when": [
        "需要在当前组织创建个人待办（标题与执行人必填；可选截止时间、优先级、按天循环）时"
      ],
      "avoid_when": [
        "只需查询已有待办时改用 dws todo task list",
        "要创建子待办时改用 dws todo task create-sub；标题或执行人未确认时不要创建"
      ],
      "examples": [
        "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\" --recurrence \"DTSTART:20260320T020000Z\\nRRULE:FREQ=DAILY;INTERVAL=1\""
      ],
      "reviewed": true,
      "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.create_personal_todo",
        "cobra-help:dws todo task create",
        "Skill:skills/mono/references/products/todo.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#todo.create_personal_todo",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#todo.create_personal_todo",
        "live-dws-schema:todo.create_personal_todo"
      ]
    },
    "todo.delete_todo": {
      "agent_summary": "删除待办",
      "use_when": [
        "用户明确要求删除指定待办（所有执行者侧一并删除）时"
      ],
      "avoid_when": [
        "用户未明确删除、目标 taskId 不确定或仍需保留任务记录时不要执行",
        "只需标记完成时改用 dws todo task done"
      ],
      "examples": [
        "dws todo task delete --task-id <taskId>"
      ],
      "reviewed": true,
      "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.delete_todo",
        "cobra-help:dws todo task delete",
        "Skill:skills/mono/references/products/todo.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#todo.delete_todo",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#todo.delete_todo",
        "live-dws-schema:todo.delete_todo"
      ]
    },
    "todo.delete_todo_comment": {
      "agent_summary": "删除待办评论",
      "use_when": [
        "用户明确要求删除指定待办下的某条评论时"
      ],
      "avoid_when": [
        "用户未明确删除，或 taskId/commentId 不确定时不要执行",
        "要新增评论时改用 dws todo comment add；要列出评论时改用 dws todo comment list"
      ],
      "examples": [
        "dws todo comment delete --task-id <taskId> --comment-id <commentId>"
      ],
      "reviewed": true,
      "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.delete_todo_comment",
        "cobra-help:dws todo comment delete",
        "Skill:skills/mono/references/products/todo.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#todo.delete_todo_comment",
        "live-dws-schema:todo.delete_todo_comment"
      ]
    },
    "todo.get_todo_detail": {
      "agent_summary": "查询待办详情",
      "use_when": [
        "已知 taskId，且调用者是创建者或执行者，需要查看单条待办详情时"
      ],
      "avoid_when": [
        "需要按条件查多个待办时改用 dws todo task list",
        "需要修改待办时改用 update/done/delete 等写命令",
        "需要读取或验证提醒规则时不要使用；当前详情接口不返回 reminderRules"
      ],
      "examples": [
        "dws todo task get --task-id <taskId>",
        "dws todo task get --task-id <taskId> --format json"
      ],
      "reviewed": true,
      "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.get_todo_detail",
        "cobra-help:dws todo task get",
        "Skill:skills/mono/references/products/todo.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#todo.get_todo_detail",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#todo.get_todo_detail",
        "live-dws-schema:todo.get_todo_detail"
      ]
    },
    "todo.get_user_todos_in_current_org": {
      "agent_summary": "查询当前组织待办，或通过 --query-all 跨组织查询全部待办",
      "use_when": [
        "需要按完成状态、优先级、角色或截止日期范围查询当前用户待办列表时；跨组织范围时显式使用 --query-all"
      ],
      "avoid_when": [
        "已知 taskId 需要完整单条详情时改用 dws todo task get"
      ],
      "examples": [
        "dws todo task list --page 1 --size 20 --status false",
        "dws todo task list --page 1 --size 20 --status false --format json"
      ],
      "reviewed": true,
      "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.get_user_todos_in_current_org",
        "cobra-help:dws todo task list",
        "Skill:skills/mono/references/products/todo.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#todo.get_user_todos_in_current_org",
        "live-dws-schema:todo.get_user_todos_in_current_org"
      ]
    },
    "todo.list_todo_comment": {
      "agent_summary": "获取待办评论列表",
      "use_when": [
        "已知 taskId，需要分页查看该待办评论时"
      ],
      "avoid_when": [
        "要新增评论时改用 dws todo comment add",
        "要删除评论时改用 dws todo comment delete"
      ],
      "examples": [
        "dws todo comment list --task-id <taskId>",
        "dws todo comment list --task-id <taskId> --page 1 --size 20"
      ],
      "reviewed": true,
      "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.list_todo_comment",
        "cobra-help:dws todo comment list",
        "Skill:skills/mono/references/products/todo.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#todo.list_todo_comment",
        "live-dws-schema:todo.list_todo_comment"
      ]
    },
    "todo.list_todo_attachment": {
      "agent_summary": "查询待办附件列表",
      "use_when": [
        "已知 taskId，需要查看该待办当前附件及其 attachmentId、文件名和大小时"
      ],
      "avoid_when": [
        "要上传附件时改用 dws todo task add-attachment",
        "要删除附件时先用本命令确认 attachmentId，再改用 dws todo task remove-attachment"
      ],
      "examples": [
        "dws todo task list-attachment --task-id <taskId>",
        "dws todo task list-attachment --task-id <taskId> --format json"
      ],
      "reviewed": true,
      "review_reason": "依据当前 Cobra Help、Todo Skill 与 helper 中的 list_todo_attachment 调用手工审阅；当前 live leaf Schema 缺失，记录失败证据并以源码契约收口。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.list_todo_attachment",
        "cobra-help:dws todo task list-attachment",
        "Skill:skills/mono/references/products/todo.md",
        "runtime-call:internal/helpers/todo.go#list_todo_attachment",
        "live-dws-schema:todo.list_todo_attachment#FAILED"
      ]
    },
    "todo.remove_task_executors": {
      "agent_summary": "移除待办执行人",
      "use_when": [
        "用户明确要求从待办移除指定执行人时"
      ],
      "avoid_when": [
        "要添加执行人时改用 dws todo task add-executor",
        "待办或执行人未确认时不要移除"
      ],
      "examples": [
        "dws todo task remove-executor --task-id <taskId> --executors <USER_ID_1>,<USER_ID_2>",
        "dws todo task remove-executor --task-id <taskId> --executors userId1 --format json"
      ],
      "reviewed": true,
      "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.remove_task_executors",
        "cobra-help:dws todo task remove-executor",
        "Skill:skills/mono/references/products/todo.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#todo.remove_task_executors",
        "live-dws-schema:todo.remove_task_executors"
      ]
    },
    "todo.remove_task_participants": {
      "agent_summary": "移除待办参与人",
      "use_when": [
        "用户明确要求从待办移除指定参与人时"
      ],
      "avoid_when": [
        "要添加参与人时改用 dws todo task add-participant",
        "待办或参与人未确认时不要移除"
      ],
      "examples": [
        "dws todo task remove-participant --task-id <taskId> --participants <USER_ID_1>,<USER_ID_2>",
        "dws todo task remove-participant --task-id <taskId> --participants userId1 --format json"
      ],
      "reviewed": true,
      "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.remove_task_participants",
        "cobra-help:dws todo task remove-participant",
        "Skill:skills/mono/references/products/todo.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#todo.remove_task_participants",
        "live-dws-schema:todo.remove_task_participants"
      ]
    },
    "todo.reset_todo_reminder": {
      "agent_summary": "整体替换或清除待办提醒规则（上游不支持规则读回）",
      "use_when": [
        "需要清除或整体替换待办提醒规则时（不传 reminder-rules 或传 [] 可清除）；非空规则会在远端调用前严格校验，成功响应仅作为写入回执"
      ],
      "avoid_when": [
        "只需追加一条提醒时改用 dws todo task add-reminder",
        "新规则与目标待办未确认时不要重置",
        "业务要求写后读取并核验 reminderRules 时不要声称可验证；当前 task get/list 均不返回提醒规则"
      ],
      "examples": [
        "dws todo task reset-reminder --task-id <taskId>",
        "dws todo task reset-reminder --task-id <taskId> --reminder-rules '[{\"dueDateOffset\":-30,\"baseTime\":\"dueTime\"},{\"reminderTimeStamp\":\"2026-03-10T18:00:00+08:00\",\"baseTime\":\"customTime\"}]'"
      ],
      "reviewed": true,
      "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.reset_todo_reminder",
        "cobra-help:dws todo task reset-reminder",
        "Skill:skills/mono/references/products/todo.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#todo.reset_todo_reminder",
        "live-dws-schema:todo.reset_todo_reminder"
      ]
    },
    "todo.update_todo_done_status": {
      "agent_summary": "修改执行者的待办完成状态",
      "use_when": [
        "已知 taskId，需要把执行者侧完成状态设为已完成或未完成时"
      ],
      "avoid_when": [
        "要改标题/截止时间/优先级时改用 dws todo task update",
        "执行人、目标待办或期望状态未确认时不要修改"
      ],
      "examples": [
        "dws todo task done --task-id <taskId> --status true",
        "dws todo task done --task-id <taskId> --status false"
      ],
      "reviewed": true,
      "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.update_todo_done_status",
        "cobra-help:dws todo task done",
        "Skill:skills/mono/references/products/todo.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#todo.update_todo_done_status",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#todo.update_todo_done_status",
        "live-dws-schema:todo.update_todo_done_status"
      ]
    },
    "todo.update_todo_task": {
      "agent_summary": "修改整个待办任务",
      "use_when": [
        "已知 taskId，需要修改待办标题、截止时间、优先级或完成标记等字段时"
      ],
      "avoid_when": [
        "只需改执行者完成状态时优先 dws todo task done",
        "目标任务与待改字段未确认时不要更新"
      ],
      "examples": [
        "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\""
      ],
      "reviewed": true,
      "review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型；pinned schema_mcp_metadata 仅对照。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.update_todo_task",
        "cobra-help:dws todo task update",
        "Skill:skills/mono/references/products/todo.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#todo.update_todo_task",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#todo.update_todo_task",
        "live-dws-schema:todo.update_todo_task"
      ]
    },
    "todo.create_todo_tag": {
      "agent_summary": "为当前用户创建一个新的待办标签",
      "use_when": [
        "用户明确要求创建可复用的待办标签，且已给出非空标签名称"
      ],
      "avoid_when": [
        "给已有待办打上现有标签应使用 todo tag add；重命名已有标签应使用 todo tag update"
      ],
      "examples": [
        "dws todo tag create --name \"项目标签\""
      ],
      "reviewed": true,
      "review_reason": "依据新增 Cobra leaf、请求封装和 Wukong 对齐实现审阅创建待办标签的选择边界与示例。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.create_todo_tag",
        "cobra-help:dws todo tag create",
        "Wukong-parity:3306c3307",
        "live-dws-schema:todo.create_todo_tag#FAILED"
      ]
    },
    "todo.delete_todo_tag": {
      "agent_summary": "不可逆地删除当前用户的一个或多个待办标签",
      "use_when": [
        "用户明确要求删除已有标签 code，且已确认标签编码及不可逆影响"
      ],
      "avoid_when": [
        "只需从某个待办移除标签或重命名标签时不要删除标签定义；未确认 code 时先用 todo tag list"
      ],
      "examples": [
        "dws todo tag delete --tag-codes code1,code2"
      ],
      "reviewed": true,
      "review_reason": "依据新增 Cobra leaf、删除确认门禁和 Wukong 对齐实现审阅待办标签删除的严格选择边界与无 --yes 合约示例。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.delete_todo_tag",
        "cobra-help:dws todo tag delete",
        "Wukong-parity:3306c3307",
        "live-dws-schema:todo.delete_todo_tag#FAILED"
      ]
    },
    "todo.list_todo_tags": {
      "agent_summary": "列出当前用户可用的待办标签及其 code",
      "use_when": [
        "需要查看待办标签目录或先取得标签 code 供打标、更新、删除使用"
      ],
      "avoid_when": [
        "查询待办任务列表应使用 todo task list；该命令只返回标签定义"
      ],
      "examples": [
        "dws todo tag list"
      ],
      "reviewed": true,
      "review_reason": "依据新增 Cobra leaf和 Wukong 对齐实现审阅标签目录查询的选择边界与无参数示例。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.list_todo_tags",
        "cobra-help:dws todo tag list",
        "Wukong-parity:3306c3307",
        "live-dws-schema:todo.list_todo_tags#FAILED"
      ]
    },
    "todo.tag_todo": {
      "agent_summary": "把一个或多个现有标签添加到指定待办",
      "use_when": [
        "已有 taskId 和标签 code，需要给该待办打标"
      ],
      "avoid_when": [
        "尚无标签 code 时先用 todo tag list 或 todo tag create；修改标签定义应使用 todo tag update"
      ],
      "examples": [
        "dws todo tag add --task-id <taskId> --tag-codes code1,code2"
      ],
      "reviewed": true,
      "review_reason": "依据新增 Cobra leaf、TodoTagRequest 映射和 Wukong 对齐实现审阅给待办打标的选择边界与示例。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.tag_todo",
        "cobra-help:dws todo tag add",
        "Wukong-parity:3306c3307",
        "live-dws-schema:todo.tag_todo#FAILED"
      ]
    },
    "todo.update_todo_tag": {
      "agent_summary": "批量更新已有待办标签的名称等定义",
      "use_when": [
        "已有标签 code，需要按 JSON 数组更新一个或多个标签定义"
      ],
      "avoid_when": [
        "给待办打标签应使用 todo tag add；创建没有 code 的新标签应使用 todo tag create"
      ],
      "examples": [
        "dws todo tag update --user-tags '[{\"code\":\"code1\",\"name\":\"新名称\"}]'"
      ],
      "reviewed": true,
      "review_reason": "依据新增 Cobra leaf、JSON 数组校验和 Wukong 对齐实现审阅待办标签更新的选择边界与示例。",
      "source_refs": [
        "CommandRegistry:canonical_path=todo.update_todo_tag",
        "cobra-help:dws todo tag update",
        "Wukong-parity:3306c3307",
        "live-dws-schema:todo.update_todo_tag#FAILED"
      ]
    },
    "todo.shortcut_assign": {
      "agent_summary": "按姓名给某人创建并指派一条待办（自动解析 userId）",
      "use_when": [
        "当你想把一件事指派给某位同事、但只知道对方姓名不想先查 userId 时使用；内部先按姓名解析出唯一 userId，再创建待办并把 TA 设为执行人。会真实创建待办。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws todo +assign --to 张三 --task \"整理周报\""
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#todo.shortcut_assign",
        "cobra-help:dws todo +assign",
        "ShortcutRegistry:todo +assign"
      ]
    },
    "todo.shortcut_assign_multi": {
      "agent_summary": "把一条待办按姓名一次性指派给多个人（自动把每个姓名解析成 userId）",
      "use_when": [
        "当你想把同一条待办同时指派给好几个同事、但手上只有他们的姓名而不是 userId 时使用；内部会把 --to 里的每个姓名逐个解析成唯一 userId，只要有任何一个姓名查不到或者重名有歧义，就把这些问题一次性汇总报错、并且完全不创建待办（不会建出只指派了一半人的残缺待办）。全部姓名都解析成功后，才用这些 userId 一次性创建这条待办并指派给所有人。会真实创建一条新的待办。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws todo +assign-multi --to \"张三,李四\" --task \"周五前提交排期\""
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#todo.shortcut_assign_multi",
        "cobra-help:dws todo +assign-multi",
        "ShortcutRegistry:todo +assign-multi"
      ]
    },
    "todo.shortcut_created_todos": {
      "agent_summary": "列出我创建的待办（我作为创建人 creator 发起的待办，而非分配给我执行的）",
      "use_when": [
        "当你想快速看清『哪些待办是我自己创建/发起的』，而不是别人指派给我执行的待办时使用；内部拉取你当前组织下角色为创建人(creator)的待办列表（roleTypes=[\"creator\"]，creator 是待办列表支持的角色枚举之一），再在本地把每条待办投影成标题(subject)、任务 ID(taskId) 和截止时间(dueTime) 打印出来。这是纯只读操作，只做列表与投影，不会创建或修改任何待办；若没有你创建的待办则返回空列表。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws todo +created-todos"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#todo.shortcut_created_todos",
        "cobra-help:dws todo +created-todos",
        "ShortcutRegistry:todo +created-todos"
      ]
    },
    "todo.shortcut_overdue": {
      "agent_summary": "列出我已过期未完成的待办",
      "use_when": [
        "当你想快速看清自己有哪些待办已经过了截止时间却还没做完、方便优先处理时使用；内部先拉取你当前组织下作为执行人(executor)的待办列表，再在本地按「有截止时间(dueTime) 且早于当前时刻 且尚未完成」的条件筛选，最后只打印这些逾期待办的标题(subject)、截止时间(dueTime) 和任务 ID(taskId)。这是纯只读操作，只做列表与本地过滤，不会修改或完成任何待办；若没有逾期待办则返回空列表。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws todo +overdue"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#todo.shortcut_overdue",
        "cobra-help:dws todo +overdue",
        "ShortcutRegistry:todo +overdue"
      ]
    },
    "todo.shortcut_remind": {
      "agent_summary": "给自己创建一条带可选截止时间的待办",
      "use_when": [
        "当你想给自己记一件事、并（可选）设一个截止时间，又不想先查自己的 userId 时使用；内部先解析当前登录用户的 userId，再显式设置 executorIds，--at 只会按 ISO8601 写入截止时间 dueTime，不会创建独立提醒规则。会真实创建待办。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令",
        "用户需要独立提醒规则时改用 dws todo task add-reminder；不要把 --at 解释成提醒时间"
      ],
      "examples": [
        "dws todo +remind --task \"交周报\" --at 2026-03-10T18:00:00+08:00"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#todo.shortcut_remind",
        "cobra-help:dws todo +remind",
        "ShortcutRegistry:todo +remind"
      ]
    },
    "todo.shortcut_todo_done": {
      "agent_summary": "按标题关键词把我的某条待办标记完成（自动定位 taskId）",
      "use_when": [
        "当你只记得某条待办的标题关键词、想直接把它标记完成，却不想先翻列表复制 taskId 时使用；内部先拉取你当前组织下作为执行人的待办列表，按标题(subject)包含关键词匹配：没匹配到会提示「没找到匹配待办」，匹配到多条会列出候选(标题+taskId)让你写得更精确，唯一命中时才把它标记为已完成。这会真实修改待办完成状态。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws todo +todo-done --task 周报"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#todo.shortcut_todo_done",
        "cobra-help:dws todo +todo-done",
        "ShortcutRegistry:todo +todo-done"
      ]
    },
    "todo.shortcut_get_my_tasks": {
      "agent_summary": "查询当前组织下我的待办列表",
      "use_when": [
        "当你想查看自己在当前组织下的待办清单、盘点未完成事项或按条件筛选任务时使用；可按完成状态、优先级、角色（创建者/执行者/参与者）和截止时间范围过滤并分页，返回匹配的待办列表。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws todo +get-my-tasks --status false --priority 40,30"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#todo.shortcut_get_my_tasks",
        "cobra-help:dws todo +get-my-tasks",
        "ShortcutRegistry:todo +get-my-tasks"
      ]
    },
    "todo.shortcut_list_sub": {
      "agent_summary": "查询子待办列表",
      "use_when": [
        "当你已知某个待办任务 ID、想了解它被拆解出的所有子任务时使用；输入父任务 ID，返回其下的子待办列表。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws todo +list-sub --task-id <taskId>"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#todo.shortcut_list_sub",
        "cobra-help:dws todo +list-sub",
        "ShortcutRegistry:todo +list-sub"
      ]
    },
    "todo.shortcut_get": {
      "agent_summary": "查询待办详情",
      "use_when": [
        "当你已知某条待办的任务 ID、想查看它的完整信息（标题、执行者、截止时间、优先级、状态等）时使用；输入任务 ID，返回该待办的详细内容。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws todo +get --task-id <taskId>"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#todo.shortcut_get",
        "cobra-help:dws todo +get",
        "ShortcutRegistry:todo +get"
      ]
    },
    "todo.shortcut_list_attachment": {
      "agent_summary": "查询待办任务的附件列表",
      "use_when": [
        "当你想查看某条待办上挂了哪些附件、或需要拿到附件 ID 以便后续删除时使用；输入任务 ID，返回该待办的附件列表。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws todo +list-attachment --task-id <taskId>"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#todo.shortcut_list_attachment",
        "cobra-help:dws todo +list-attachment",
        "ShortcutRegistry:todo +list-attachment"
      ]
    },
    "todo.shortcut_list_comment": {
      "agent_summary": "查询待办评论列表",
      "use_when": [
        "当你想查看某条待办下的讨论记录、了解协作沟通历史或获取评论 ID 以便删除时使用；输入任务 ID 并可分页，返回该待办的评论列表。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws todo +list-comment --task-id <taskId>"
      ],
      "reviewed": true,
      "review_reason": "Agent-authored and reviewed from the built-in Shortcut intent, executable Cobra path, and declared outcome; it affects selection only and does not alter execution or safety facts.",
      "source_refs": [
        "internal/cli/schema_command_registry.json#todo.shortcut_list_comment",
        "cobra-help:dws todo +list-comment",
        "ShortcutRegistry:todo +list-comment"
      ]
    }
  },
  "products": {
    "todo": {
      "agent_summary": "管理待办任务、标签、子任务、执行人、参与人、评论、附件与提醒",
      "use_when": [
        "查询、创建或更新个人待办及其协作信息时"
      ],
      "avoid_when": [
        "不要用于 OA 审批流转、工作日志提交或日历日程管理"
      ],
      "reviewed": true,
      "review_reason": "依据真实 CommandRegistry 命令分区与对应产品 Skill 审阅产品级选择边界。",
      "source_refs": [
        "CommandRegistry:product=todo",
        "Skill:skills/mono/references/products/todo.md"
      ]
    }
  }
}