Files
修雨 2c10be2a1a feat(schema): publish 210 built-in shortcuts (#802)
Publishes all 210 public built-in shortcuts as reviewed Agent-visible
leaf tools across 16 product groups, with stable canonical identities,
executable +shortcut CLI paths, parameter and cross-parameter
constraints, selection guidance, interface metadata, and runtime-aligned
safety/confirmation semantics. Catalog grows from 603 to 813 tools.
2026-07-28 00:11:29 +08:00

516 lines
26 KiB
JSON

{
"version": 1,
"source": {
"kind": "explicit",
"name": "dws-agent-selection/oa",
"repository": "DingTalk-Real-AI/dingtalk-workspace-cli",
"channel": "open-source",
"reviewed": true
},
"tools": {
"oa.approve_processInstance": {
"agent_summary": "同意审批",
"use_when": [
"已知 processInstanceId 与待办 taskId,用户明确要求同意该审批任务时"
],
"avoid_when": [
"实例或 taskId 未确认时不要同意;先用 list-pending / tasks 取 ID",
"要拒绝时改用 dws oa approval reject;要撤销自己发起的单时改用 revoke"
],
"examples": [
"dws oa approval approve --instance-id <id> --task-id <taskId>",
"dws oa approval approve --instance-id <id> --task-id <taskId> --remark \"同意\""
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型;pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"CommandRegistry:canonical_path=oa.approve_processInstance",
"cobra-help:dws oa approval approve",
"Skill:skills/mono/references/products/oa.md",
"structured-hint:internal/cli/schema_hints/selection-review.json#oa.approve_processInstance",
"structured-hint:internal/cli/schema_hints/imported/wukong.json#oa.approve_processInstance",
"live-dws-schema:oa.approve_processInstance"
]
},
"oa.dingflow_comments": {
"agent_summary": "用户添加审批评论",
"use_when": [
"已知 processInstanceId,需要为审批实例添加评论文本时"
],
"avoid_when": [
"只需同意/拒绝/转交时改用对应写命令",
"评论内容或实例未确认时不要添加"
],
"examples": [
"dws oa approval oa-comments --instance-id <processInstanceId> --content \"同意,请尽快处理\"",
"dws oa approval oa-comments --instance-id <processInstanceId> --content \"同意,请尽快处理\" --format json"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型;pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"CommandRegistry:canonical_path=oa.dingflow_comments",
"cobra-help:dws oa approval oa-comments",
"Skill:skills/mono/references/products/oa.md",
"structured-hint:internal/cli/schema_hints/selection-review.json#oa.dingflow_comments",
"live-dws-schema:oa.dingflow_comments"
]
},
"oa.get_done_tasks": {
"agent_summary": "获取员工已处理任务列表",
"use_when": [
"需要查看当前用户已经处理过的审批单列表时"
],
"avoid_when": [
"要看待处理单时改用 dws oa approval list-pending",
"要看自己发起或抄送时改用 list-submitted / list-cc"
],
"examples": [
"dws oa approval list-executed --limit <pageSize> --page <pageNumber> --query 关键词",
"dws oa approval list-executed --limit <pageSize> --page <pageNumber> --query 关键词 --format json"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型;pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"CommandRegistry:canonical_path=oa.get_done_tasks",
"cobra-help:dws oa approval list-executed",
"Skill:skills/mono/references/products/oa.md",
"structured-hint:internal/cli/schema_hints/selection-review.json#oa.get_done_tasks",
"live-dws-schema:oa.get_done_tasks"
]
},
"oa.get_noticed_instances": {
"agent_summary": "获取抄送用户的列表",
"use_when": [
"需要查看抄送给当前用户的审批单列表时"
],
"avoid_when": [
"要看待处理或自己发起的审批时不要使用",
"该命令只列抄送实例,不执行审批动作"
],
"examples": [
"dws oa approval list-cc --limit <pageSize> --page <pageNumber> --query 关键词",
"dws oa approval list-cc --limit <pageSize> --page <pageNumber> --query 关键词 --format json"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型;pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"CommandRegistry:canonical_path=oa.get_noticed_instances",
"cobra-help:dws oa approval list-cc",
"Skill:skills/mono/references/products/oa.md",
"structured-hint:internal/cli/schema_hints/selection-review.json#oa.get_noticed_instances",
"live-dws-schema:oa.get_noticed_instances"
]
},
"oa.get_processInstance_detail": {
"agent_summary": "获取指定审批实例的详情信息",
"use_when": [
"已知 processInstanceId,需要查看表单内容与当前状态详情时"
],
"avoid_when": [
"需要操作历史而非表单详情时改用 dws oa approval records",
"该命令不会同意/拒绝/撤销"
],
"examples": [
"dws oa approval detail --instance-id <processInstanceId>",
"dws oa approval detail --instance-id <processInstanceId> --format json"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型;pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"CommandRegistry:canonical_path=oa.get_processInstance_detail",
"cobra-help:dws oa approval detail",
"Skill:skills/mono/references/products/oa.md",
"structured-hint:internal/cli/schema_hints/selection-review.json#oa.get_processInstance_detail",
"structured-hint:internal/cli/schema_hints/imported/wukong.json#oa.get_processInstance_detail",
"live-dws-schema:oa.get_processInstance_detail"
]
},
"oa.get_processInstance_records": {
"agent_summary": "获取审批操作记录",
"use_when": [
"已知 processInstanceId,需要查看谁做了什么审批操作及结果时"
],
"avoid_when": [
"需要当前表单详情时改用 dws oa approval detail",
"该命令只读历史,不处理审批"
],
"examples": [
"dws oa approval records --instance-id <processInstanceId>",
"dws oa approval records --instance-id <processInstanceId> --format json"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型;pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"CommandRegistry:canonical_path=oa.get_processInstance_records",
"cobra-help:dws oa approval records",
"Skill:skills/mono/references/products/oa.md",
"structured-hint:internal/cli/schema_hints/selection-review.json#oa.get_processInstance_records",
"structured-hint:internal/cli/schema_hints/imported/wukong.json#oa.get_processInstance_records",
"live-dws-schema:oa.get_processInstance_records"
]
},
"oa.get_submitted_instances": {
"agent_summary": "获取已提交实例列表",
"use_when": [
"需要查看当前用户已提交/发起相关的审批单列表时"
],
"avoid_when": [
"要按 processCode 与时间窗列已发起实例时也可对照 list-initiated",
"要处理待办时改用 list-pending / tasks"
],
"examples": [
"dws oa approval list-submitted --limit <pageSize> --page <pageNumber> --query 关键词",
"dws oa approval list-submitted --limit <pageSize> --page <pageNumber> --query 关键词 --format json"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型;pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"CommandRegistry:canonical_path=oa.get_submitted_instances",
"cobra-help:dws oa approval list-submitted",
"Skill:skills/mono/references/products/oa.md",
"structured-hint:internal/cli/schema_hints/selection-review.json#oa.get_submitted_instances",
"live-dws-schema:oa.get_submitted_instances"
]
},
"oa.list_initiated_instances": {
"agent_summary": "查询当前用户已发起的审批实例列表",
"use_when": [
"已知 processCode,需要按起止时间查询自己发起的审批实例基础信息时"
],
"avoid_when": [
"不知道 processCode 时先用 dws oa approval list-forms",
"要撤销实例时先确认 instanceId 再改用 revoke"
],
"examples": [
"dws oa approval list-initiated --process-code <code> --start \"2026-03-10T00:00:00+08:00\" --end \"2026-03-10T23:59:59+08:00\" --cursor 0 --limit 20",
"dws oa approval list-initiated --process-code <code> --start \"2026-03-10T00:00:00+08:00\" --end \"2026-03-10T23:59:59+08:00\" --cursor 0 --limit 20 --format json"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型;pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"CommandRegistry:canonical_path=oa.list_initiated_instances",
"cobra-help:dws oa approval list-initiated",
"Skill:skills/mono/references/products/oa.md",
"structured-hint:internal/cli/schema_hints/selection-review.json#oa.list_initiated_instances",
"structured-hint:internal/cli/schema_hints/imported/wukong.json#oa.list_initiated_instances",
"live-dws-schema:oa.list_initiated_instances"
]
},
"oa.list_pending_approvals": {
"agent_summary": "查询当前用户待处理的审批单列表",
"use_when": [
"需要查看待我处理的审批单并提取 processInstanceId / 跳转链接时"
],
"avoid_when": [
"已知实例只要 taskId 时改用 dws oa approval tasks",
"不要用本命令执行同意/拒绝"
],
"examples": [
"dws oa approval list-pending --start \"2026-03-10T00:00:00+08:00\" --end \"2026-03-10T23:59:59+08:00\"",
"dws oa approval list-pending --start \"2026-03-10T00:00:00+08:00\" --end \"2026-03-10T23:59:59+08:00\" --query 关键词"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型;pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"CommandRegistry:canonical_path=oa.list_pending_approvals",
"cobra-help:dws oa approval list-pending",
"Skill:skills/mono/references/products/oa.md",
"structured-hint:internal/cli/schema_hints/selection-review.json#oa.list_pending_approvals",
"structured-hint:internal/cli/schema_hints/imported/wukong.json#oa.list_pending_approvals",
"live-dws-schema:oa.list_pending_approvals"
]
},
"oa.list_pending_tasks": {
"agent_summary": "查询待我审批的任务Id",
"use_when": [
"已知 processInstanceId,需要取得当前用户待办 taskId 以便同意或拒绝时"
],
"avoid_when": [
"还不知道实例列表时先用 dws oa approval list-pending",
"本命令只取 taskId,不执行审批"
],
"examples": [
"dws oa approval tasks --instance-id <processInstanceId>",
"dws oa approval tasks --instance-id <processInstanceId> --format json"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型;pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"CommandRegistry:canonical_path=oa.list_pending_tasks",
"cobra-help:dws oa approval tasks",
"Skill:skills/mono/references/products/oa.md",
"structured-hint:internal/cli/schema_hints/selection-review.json#oa.list_pending_tasks",
"structured-hint:internal/cli/schema_hints/imported/wukong.json#oa.list_pending_tasks",
"live-dws-schema:oa.list_pending_tasks"
]
},
"oa.list_user_visible_process": {
"agent_summary": "获取当前用户可见的审批表单列表",
"use_when": [
"需要列出可见审批模板并取得 processCode 时"
],
"avoid_when": [
"需要实例、任务或操作记录时不要使用;该命令只列可见模板"
],
"examples": [
"dws oa approval list-forms --cursor 0 --limit 100",
"dws oa approval list-forms --cursor 0 --limit 100 --format json"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型;pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"CommandRegistry:canonical_path=oa.list_user_visible_process",
"cobra-help:dws oa approval list-forms",
"Skill:skills/mono/references/products/oa.md",
"structured-hint:internal/cli/schema_hints/selection-review.json#oa.list_user_visible_process",
"structured-hint:internal/cli/schema_hints/imported/wukong.json#oa.list_user_visible_process",
"live-dws-schema:oa.list_user_visible_process"
]
},
"oa.oa_cc_noticer": {
"agent_summary": "抄送审批人",
"use_when": [
"已知 processInstanceId,需要为审批实例追加抄送人时"
],
"avoid_when": [
"只需查看抄送列表时改用 dws oa approval list-cc",
"实例与抄送人未确认时不要添加"
],
"examples": [
"dws oa approval oa-cc-noticer --instance-id <processInstanceId> --users \"68674200835816\"",
"dws oa approval oa-cc-noticer --instance-id <processInstanceId> --users \"userId1,userId2\" --operator-id \"123123\""
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型;pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"CommandRegistry:canonical_path=oa.oa_cc_noticer",
"cobra-help:dws oa approval oa-cc-noticer",
"Skill:skills/mono/references/products/oa.md",
"structured-hint:internal/cli/schema_hints/selection-review.json#oa.oa_cc_noticer",
"live-dws-schema:oa.oa_cc_noticer"
]
},
"oa.redirect_task": {
"agent_summary": "转交审批任务",
"use_when": [
"已知 taskId 与接收人 toActionerId,用户明确要求转交审批任务时"
],
"avoid_when": [
"任务、接收人或转交意图未确认时不要转交",
"要自己处理时改用 approve/reject"
],
"examples": [
"dws oa approval redirect-task --task-id <taskId> --to-actioner-id <userId>",
"dws oa approval redirect-task --task-id <taskId> --to-actioner-id <userId> --remark \"请帮忙处理\""
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型;pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"CommandRegistry:canonical_path=oa.redirect_task",
"cobra-help:dws oa approval redirect-task",
"Skill:skills/mono/references/products/oa.md",
"structured-hint:internal/cli/schema_hints/selection-review.json#oa.redirect_task",
"live-dws-schema:oa.redirect_task"
]
},
"oa.reject_processInstance": {
"agent_summary": "拒绝审批",
"use_when": [
"已知 processInstanceId 与 taskId,用户明确要求拒绝/驳回该审批任务时"
],
"avoid_when": [
"要同意时改用 dws oa approval approve",
"实例、taskId 或拒绝原因未确认时不要拒绝"
],
"examples": [
"dws oa approval reject --instance-id <id> --task-id <taskId> --remark \"不同意\"",
"dws oa approval reject --instance-id <id> --task-id <taskId> --remark \"不符合要求\" --format json"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型;pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"CommandRegistry:canonical_path=oa.reject_processInstance",
"cobra-help:dws oa approval reject",
"Skill:skills/mono/references/products/oa.md",
"structured-hint:internal/cli/schema_hints/selection-review.json#oa.reject_processInstance",
"structured-hint:internal/cli/schema_hints/imported/wukong.json#oa.reject_processInstance",
"live-dws-schema:oa.reject_processInstance"
]
},
"oa.revoke_processInstance": {
"agent_summary": "撤销当前用户已发起的审批实例",
"use_when": [
"用户明确要求撤销自己已发起的审批实例,且 processInstanceId 已确认时"
],
"avoid_when": [
"不是自己发起的单或 instanceId 未确认时不要撤销",
"要拒绝别人的待办时改用 reject,不要用 revoke"
],
"examples": [
"dws oa approval revoke --instance-id <instance-id>"
],
"reviewed": true,
"review_reason": "结合本机 dws schema 实时描述、Skill 与 Cobra 手写选型;pinned schema_mcp_metadata 仅对照。",
"source_refs": [
"CommandRegistry:canonical_path=oa.revoke_processInstance",
"cobra-help:dws oa approval revoke",
"Skill:skills/mono/references/products/oa.md",
"structured-hint:internal/cli/schema_hints/selection-review.json#oa.revoke_processInstance",
"structured-hint:internal/cli/schema_hints/imported/wukong.json#oa.revoke_processInstance",
"live-dws-schema:oa.revoke_processInstance"
]
},
"oa.shortcut_list_pending": {
"agent_summary": "查询待我处理的审批(时间范围为 epoch 毫秒)",
"use_when": [
"当你想知道自己当前有哪些审批还没处理、需要清理审批待办或按时间段/关键字盘点待审批单时使用;传入起止时间(epoch 毫秒,可选关键字与分页),返回待我审批的实例列表,是后续 +get 查详情、+approve/+reject 处理的入口。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令"
],
"examples": [
"dws oa +list-pending --start 1741536000000 --end 1741622399000 --query 报销"
],
"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#oa.shortcut_list_pending",
"cobra-help:dws oa +list-pending",
"ShortcutRegistry:oa +list-pending"
]
},
"oa.shortcut_list_forms": {
"agent_summary": "获取当前用户可见的审批表单列表",
"use_when": [
"当你想浏览自己有权限发起哪些审批模板、或需要为 +list-initiated 等操作枚举 processCode 时使用;无需关键字,按游标分页返回当前用户可见的全部审批表单,适合不确定表单名称时先整体看一遍。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令"
],
"examples": [
"dws oa +list-forms --cursor 0 --limit 100"
],
"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#oa.shortcut_list_forms",
"cobra-help:dws oa +list-forms",
"ShortcutRegistry:oa +list-forms"
]
},
"oa.shortcut_search_forms": {
"agent_summary": "按关键字模糊搜索当前用户可见的审批表单",
"use_when": [
"当你已知想找的审批大致名称(如「报销」「请假」)、想快速定位对应表单及其 processCode 时使用,比 +list-forms 全量列举更高效;传入关键字,返回名称或 processCode 匹配的表单,供后续 +list-initiated 按模板查询。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令"
],
"examples": [
"dws oa +search-forms --query 报销"
],
"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#oa.shortcut_search_forms",
"cobra-help:dws oa +search-forms",
"ShortcutRegistry:oa +search-forms"
]
},
"oa.shortcut_list_executed": {
"agent_summary": "获取当前用户已经处理过的审批单列表",
"use_when": [
"当你想回顾自己历史上审批过(已同意/拒绝等)的单子、做复盘或查找某条已办审批时使用,区别于 +list-pending 的待办;按页码/关键字分页返回我已处理的审批单。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令"
],
"examples": [
"dws oa +list-executed --limit 20 --page 1 --query 报销"
],
"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#oa.shortcut_list_executed",
"cobra-help:dws oa +list-executed",
"ShortcutRegistry:oa +list-executed"
]
},
"oa.shortcut_list_submitted": {
"agent_summary": "获取当前用户已发起的审批单列表",
"use_when": [
"当你想查看自己提交发起的审批单及其审批进度(如某笔报销/请假审到哪一步)时使用;按页码/关键字分页返回我发起的审批单,可据此决定是否 +revoke 撤销或催办。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令"
],
"examples": [
"dws oa +list-submitted --limit 20 --page 1 --query 报销"
],
"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#oa.shortcut_list_submitted",
"cobra-help:dws oa +list-submitted",
"ShortcutRegistry:oa +list-submitted"
]
},
"oa.shortcut_list_cc": {
"agent_summary": "获取抄送当前用户的审批单列表",
"use_when": [
"当你想查看抄送给自己、需要知悉但无需审批的单子时使用;按页码/关键字分页返回抄送我的审批单列表,适合了解与自己相关但不用自己动手处理的审批动态。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令"
],
"examples": [
"dws oa +list-cc --limit 20 --page 1 --query 报销"
],
"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#oa.shortcut_list_cc",
"cobra-help:dws oa +list-cc",
"ShortcutRegistry:oa +list-cc"
]
},
"oa.shortcut_my_initiated": {
"agent_summary": "列出我发起(提交)的审批单据",
"use_when": [
"当你想快速看清自己发起(提交)过哪些 OA 审批单据、方便跟进它们的进展时使用;内部直接拉取当前用户已发起的审批实例列表(等价于 dws oa approval list-submitted),再在本地把每条单据投影成标题、单号(businessId)、状态和审批实例 ID(processInstanceId) 四个关键字段。可用 --query 按关键字过滤、--page/--limit 翻页(默认第 1 页、每页 20 条)。这是纯只读操作,只做列表与本地投影,不会同意、拒绝、撤销或修改任何审批单据;若没有发起过审批则返回空列表。"
],
"avoid_when": [
"需要该 Shortcut 未公开的底层参数、原始响应或不同执行语义时,改用对应原子命令"
],
"examples": [
"dws oa +my-initiated",
"dws oa +my-initiated --query 报销"
],
"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#oa.shortcut_my_initiated",
"cobra-help:dws oa +my-initiated",
"ShortcutRegistry:oa +my-initiated"
]
}
},
"products": {
"oa": {
"agent_summary": "查询和处理 OA 审批实例、任务、记录、抄送与评论",
"use_when": [
"查看待审、已办、已发起或抄送审批,并执行同意、拒绝、撤销、转交等审批动作时"
],
"avoid_when": [
"不要用于普通待办任务或工作日志;需要创建审批实例时先确认当前命令面是否支持"
],
"reviewed": true,
"review_reason": "依据真实 CommandRegistry 命令分区与对应产品 Skill 审阅产品级选择边界。",
"source_refs": [
"CommandRegistry:product=oa",
"Skill:skills/mono/references/products/oa.md"
]
}
}
}