{ "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 --task-id ", "dws oa approval approve --instance-id --task-id --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 --content \"同意，请尽快处理\"", "dws oa approval oa-comments --instance-id --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 --page --query 关键词", "dws oa approval list-executed --limit --page --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 --page --query 关键词", "dws oa approval list-cc --limit --page --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 ", "dws oa approval detail --instance-id --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 ", "dws oa approval records --instance-id --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 --page --query 关键词", "dws oa approval list-submitted --limit --page --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 --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 --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 ", "dws oa approval tasks --instance-id --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 --users \"68674200835816\"", "dws oa approval oa-cc-noticer --instance-id --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 --to-actioner-id ", "dws oa approval redirect-task --task-id --to-actioner-id --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 --task-id --remark \"不同意\"", "dws oa approval reject --instance-id --task-id --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 " ], "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" ] } } }