dingtalk-workspace-cli/internal/cli/schema_hints/selection/ding.json

{
  "version": 1,
  "source": {
    "kind": "explicit",
    "name": "dws-agent-selection/ding",
    "repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
    "channel": "open-source",
    "reviewed": true
  },
  "tools": {
    "ding.recall_ding_message": {
      "agent_summary": "撤回已发送的机器人 DING",
      "use_when": [
        "已知 openDingId 与同一 robot-code，需要撤回机器人 DING"
      ],
      "avoid_when": [
        "需要以用户身份撤回 DING 时不要使用本命令"
      ],
      "examples": [
        "dws ding message recall --robot-code <ROBOT_CODE> --id <OPEN_DING_ID> --format json"
      ],
      "reviewed": true,
      "review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
      "source_refs": [
        "CommandRegistry:canonical_path=ding.recall_ding_message",
        "cobra-help:dws ding message recall",
        "Skill:skills/mono/references/products/ding.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#ding.recall_ding_message",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#ding.recall_ding_message",
        "internal/cli/schema_command_registry.json#ding.recall_ding_message",
        "skills/mono/references/products/ding.md",
        "live-dws-schema:ding.recall_ding_message"
      ]
    },
    "ding.send_ding_message": {
      "agent_summary": "以企业机器人发送应用内/短信/电话 DING",
      "use_when": [
        "需要用企业机器人向指定 userId 发送应用内、短信或电话 DING"
      ],
      "avoid_when": [
        "普通聊天消息用 chat message send / send-by-bot",
        "需要用户身份 DING 时不要用本命令（机器人身份）",
        "短信/电话有成本，用户未确认前不要发 call/sms"
      ],
      "examples": [
        "dws ding message send --robot-code <ROBOT_CODE> --users userId1,userId2 --content \"请查看\" --format json",
        "dws ding message send --robot-code <ROBOT_CODE> --type call --users userId1 --content \"紧急告警\" --format json"
      ],
      "reviewed": true,
      "review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
      "source_refs": [
        "CommandRegistry:canonical_path=ding.send_ding_message",
        "cobra-help:dws ding message send",
        "Skill:skills/mono/references/products/ding.md",
        "structured-hint:internal/cli/schema_hints/selection-review.json#ding.send_ding_message",
        "structured-hint:internal/cli/schema_hints/imported/wukong.json#ding.send_ding_message",
        "internal/cli/schema_command_registry.json#ding.send_ding_message",
        "skills/mono/references/products/ding.md",
        "live-dws-schema:ding.send_ding_message"
      ]
    },
    "ding.shortcut_list": {
      "agent_summary": "查询 DING 消息列表",
      "use_when": [
        "当你想查看当前身份收到或发出的 DING 消息、回顾有哪些强提醒或获取某条 DING 的 openDingId 以便后续查已读或撤回时使用；可选按类型过滤并用 cursor 翻页，只读不产生副作用。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws ding +list"
      ],
      "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#ding.shortcut_list",
        "cobra-help:dws ding +list",
        "ShortcutRegistry:ding +list"
      ]
    },
    "ding.shortcut_receiver_status": {
      "agent_summary": "查询 DING 消息接收人已读状态",
      "use_when": [
        "当你发出一条 DING 后想确认每位接收人是否已读、追踪谁还没看到以便催办时使用；需提供该 DING 的 openDingId，返回各接收人的已读/未读状态，只读操作。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws ding +receiver-status --ding-id <DING_ID>"
      ],
      "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#ding.shortcut_receiver_status",
        "cobra-help:dws ding +receiver-status",
        "ShortcutRegistry:ding +receiver-status"
      ]
    },
    "ding.shortcut_send_personal": {
      "agent_summary": "以本人身份发送 DING 给指定人",
      "use_when": [
        "当你想以自己（而非机器人）的身份直接给某些同事发 DING 强提醒，让对方看到是本人发起时使用；需提供接收人的 openDingTalkId 列表和内容，可选提醒方式与幂等 uuid，会真实向这些人发出 DING。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws ding +send-personal --users <VALUES> --content <CONTENT>"
      ],
      "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#ding.shortcut_send_personal",
        "cobra-help:dws ding +send-personal",
        "ShortcutRegistry:ding +send-personal"
      ]
    },
    "ding.shortcut_recall_personal": {
      "agent_summary": "撤回本人发起的 DING",
      "use_when": [
        "当你以本人身份发出的某条 DING 发错人或内容有误、想收回时使用（对应 send-personal/send-by-message 发出的 DING）；需提供该 DING 的 openDingId，会真实撤回它，接收人将不再看到该提醒。"
      ],
      "avoid_when": [
        "需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时，改用对应原子命令"
      ],
      "examples": [
        "dws ding +recall-personal --id <ID>"
      ],
      "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#ding.shortcut_recall_personal",
        "cobra-help:dws ding +recall-personal",
        "ShortcutRegistry:ding +recall-personal"
      ]
    }
  },
  "products": {
    "ding": {
      "agent_summary": "以企业机器人发送或撤回应用内/短信/电话 DING",
      "use_when": [
        "需要机器人身份发送或撤回 DING"
      ],
      "avoid_when": [
        "普通聊天消息用 chat；用户身份 DING 不要走机器人命令"
      ],
      "reviewed": true,
      "review_reason": "人工依据实时 dws schema（或 Skill/Cobra/pinned MCP 对照）决策化选型文案与门禁；不改写命令身份与参数契约；示例不含 --yes。",
      "source_refs": [
        "CommandRegistry:product=ding",
        "Skill:skills/mono/references/products/ding.md",
        "live-dws-schema:product-batch-2026-07-14"
      ]
    }
  }
}