Files
dingtalk-workspace-cli/internal/cli/schema_agent_metadata/oa.json
T
玉澜 cf8cf95087 feat(schema): add sibling-command disambiguation to avoid_when
Add skills/mono/schema-hints/sibling-disambiguation.json: for each multi-segment
command sub-group (aitable view update, sheet range, chat message, ...), append
explicit cross-referencing avoid_when entries pointing agents to the correct
sibling command. Regenerate embedded agent metadata + catalog: 395/504 tools now
carry sibling disambiguation, improving tool-selection beyond template-only
avoid_when. drift/catalog gates and go test ./internal/cli pass.
2026-07-11 14:02:05 +08:00

517 lines
21 KiB
JSON
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
{
"product_id": "oa",
"tools": {
"oa approval approve": {
"agent_summary": "同意审批",
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
"use_when": [
"4a. 同意审批",
"同意审批/批准"
],
"avoid_when": [
"要“用户添加审批评论”请改用 dws oa approval oa-comments",
"要“获取员工已处理任务列表”请改用 dws oa approval list-executed",
"要“获取抄送用户的列表”请改用 dws oa approval list-cc"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"examples": [
"dws oa approval approve --instance-id \u003cid\u003e --task-id \u003ctaskId\u003e",
"dws oa approval approve --instance-id \u003cid\u003e --task-id \u003ctaskId\u003e --remark \"同意\""
],
"source_refs": [
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.approve_processInstance",
"skills/mono/references/products/oa.md",
"skills/mono/references/products/simple.md",
"skills/mono/schema-hints/imported/wukong.json",
"skills/mono/schema-hints/selection-review.json",
"skills/mono/schema-hints/sibling-disambiguation.json"
],
"interface_ref": {
"product_id": "oa",
"rpc_name": "approve_processInstance"
},
"interface_mode": "mcp",
"availability": "available"
},
"oa approval detail": {
"agent_summary": "获取审批实例详情",
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
"use_when": [
"2. 查看审批详情 — 了解审批内容",
"审批详情/看审批"
],
"avoid_when": [
"要“同意审批”请改用 dws oa approval approve",
"要“用户添加审批评论”请改用 dws oa approval oa-comments",
"要“获取员工已处理任务列表”请改用 dws oa approval list-executed"
],
"effect": "read",
"effect_source": "command-verb",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws oa approval detail --instance-id \u003cprocessInstanceId\u003e",
"dws oa approval detail --instance-id \u003cprocessInstanceId\u003e --format json"
],
"source_refs": [
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.get_processInstance_detail",
"skills/mono/references/products/oa.md",
"skills/mono/schema-hints/imported/wukong.json",
"skills/mono/schema-hints/selection-review.json",
"skills/mono/schema-hints/sibling-disambiguation.json"
],
"interface_ref": {
"product_id": "oa",
"rpc_name": "get_processInstance_detail"
},
"interface_mode": "mcp",
"availability": "available"
},
"oa approval list-cc": {
"agent_summary": "获取抄送用户的列表",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"11. 抄送我的审批单",
"抄送我的审批单"
],
"avoid_when": [
"要“同意审批”请改用 dws oa approval approve",
"要“用户添加审批评论”请改用 dws oa approval oa-comments",
"要“获取员工已处理任务列表”请改用 dws oa approval list-executed"
],
"effect": "read",
"effect_source": "command-verb",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws oa approval list-cc --limit \u003cpageSize\u003e --page \u003cpageNumber\u003e --query 关键词",
"dws oa approval list-cc --limit \u003cpageSize\u003e --page \u003cpageNumber\u003e --query 关键词 --format json"
],
"reviewed": false,
"source_refs": [
"internal/cli/schema_mcp_metadata.json#tools.oa.get_noticed_instances",
"skills/mono/references/products/oa.md",
"skills/mono/schema-hints/selection-review.json",
"skills/mono/schema-hints/sibling-disambiguation.json"
],
"interface_mode": "mcp",
"availability": "available"
},
"oa approval list-executed": {
"agent_summary": "获取员工已处理任务列表",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"9. 我处理过的审批单",
"我审批/处理过的审批单"
],
"avoid_when": [
"要“同意审批”请改用 dws oa approval approve",
"要“用户添加审批评论”请改用 dws oa approval oa-comments",
"要“获取抄送用户的列表”请改用 dws oa approval list-cc"
],
"effect": "read",
"effect_source": "command-verb",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws oa approval list-executed --limit \u003cpageSize\u003e --page \u003cpageNumber\u003e --query 关键词",
"dws oa approval list-executed --limit \u003cpageSize\u003e --page \u003cpageNumber\u003e --query 关键词 --format json"
],
"reviewed": false,
"source_refs": [
"internal/cli/schema_mcp_metadata.json#tools.oa.get_done_tasks",
"skills/mono/references/products/oa.md",
"skills/mono/schema-hints/selection-review.json",
"skills/mono/schema-hints/sibling-disambiguation.json"
],
"interface_mode": "mcp",
"availability": "available"
},
"oa approval list-forms": {
"agent_summary": "获取当前用户可见的审批表单列表",
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
"use_when": [
"7. 获取可见审批表单(得到 processCode)",
"有哪些审批表单/可见表单"
],
"avoid_when": [
"要“同意审批”请改用 dws oa approval approve",
"要“用户添加审批评论”请改用 dws oa approval oa-comments",
"要“获取员工已处理任务列表”请改用 dws oa approval list-executed"
],
"effect": "read",
"effect_source": "command-verb",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws oa approval list-forms --cursor 0 --limit 100",
"dws oa approval list-forms --cursor 0 --limit 100 --format json"
],
"source_refs": [
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.list_user_visible_process",
"skills/mono/references/products/oa.md",
"skills/mono/schema-hints/imported/wukong.json",
"skills/mono/schema-hints/selection-review.json",
"skills/mono/schema-hints/sibling-disambiguation.json"
],
"interface_ref": {
"product_id": "oa",
"rpc_name": "list_user_visible_process"
},
"interface_mode": "mcp",
"availability": "available"
},
"oa approval list-initiated": {
"agent_summary": "查询已发起的审批实例列表",
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
"use_when": [
"8. 查看自己发起的审批列表(--process-code 来自 list-forms / search-forms / detail)",
"我发起的审批"
],
"avoid_when": [
"要“同意审批”请改用 dws oa approval approve",
"要“用户添加审批评论”请改用 dws oa approval oa-comments",
"要“获取员工已处理任务列表”请改用 dws oa approval list-executed"
],
"effect": "read",
"effect_source": "command-verb",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws oa approval list-initiated --process-code \u003ccode\u003e --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 \u003ccode\u003e --start \"2026-03-10T00:00:00+08:00\" --end \"2026-03-10T23:59:59+08:00\" --cursor 0 --limit 20 --format json"
],
"source_refs": [
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.list_initiated_instances",
"skills/mono/references/products/oa.md",
"skills/mono/references/products/simple.md",
"skills/mono/schema-hints/imported/wukong.json",
"skills/mono/schema-hints/selection-review.json",
"skills/mono/schema-hints/sibling-disambiguation.json"
],
"interface_ref": {
"product_id": "oa",
"rpc_name": "list_initiated_instances"
},
"interface_mode": "mcp",
"availability": "available"
},
"oa approval list-pending": {
"agent_summary": "查询待我处理的审批",
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
"use_when": [
"1. 查看待我处理的审批 — 提取 processInstanceId",
"待审批/待处理审批",
"待我审批/我要审批的"
],
"avoid_when": [
"要“同意审批”请改用 dws oa approval approve",
"要“用户添加审批评论”请改用 dws oa approval oa-comments",
"要“获取员工已处理任务列表”请改用 dws oa approval list-executed"
],
"effect": "read",
"effect_source": "command-verb",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"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 关键词"
],
"source_refs": [
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.list_pending_approvals",
"skills/mono/references/products/oa.md",
"skills/mono/references/products/simple.md",
"skills/mono/schema-hints/imported/wukong.json",
"skills/mono/schema-hints/selection-review.json",
"skills/mono/schema-hints/sibling-disambiguation.json"
],
"interface_ref": {
"product_id": "oa",
"rpc_name": "list_pending_approvals"
},
"interface_mode": "mcp",
"availability": "available"
},
"oa approval list-submitted": {
"agent_summary": "获取已提交实例列表",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"10. 我发起的审批单",
"我发起的审批单"
],
"avoid_when": [
"要“同意审批”请改用 dws oa approval approve",
"要“用户添加审批评论”请改用 dws oa approval oa-comments",
"要“获取员工已处理任务列表”请改用 dws oa approval list-executed"
],
"effect": "read",
"effect_source": "command-verb",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws oa approval list-submitted --limit \u003cpageSize\u003e --page \u003cpageNumber\u003e --query 关键词",
"dws oa approval list-submitted --limit \u003cpageSize\u003e --page \u003cpageNumber\u003e --query 关键词 --format json"
],
"reviewed": false,
"source_refs": [
"internal/cli/schema_mcp_metadata.json#tools.oa.get_submitted_instances",
"skills/mono/references/products/oa.md",
"skills/mono/schema-hints/selection-review.json",
"skills/mono/schema-hints/sibling-disambiguation.json"
],
"interface_mode": "mcp",
"availability": "available"
},
"oa approval oa-cc-noticer": {
"agent_summary": "抄送审批人",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"14. 对审批实例进行抄送(processInstanceId 来自 list-pending 或 detail)",
"抄送审批/添加抄送人"
],
"avoid_when": [
"要“同意审批”请改用 dws oa approval approve",
"要“用户添加审批评论”请改用 dws oa approval oa-comments",
"要“获取员工已处理任务列表”请改用 dws oa approval list-executed"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"examples": [
"dws oa approval oa-cc-noticer --instance-id \u003cprocessInstanceId\u003e --users \"68674200835816\"",
"dws oa approval oa-cc-noticer --instance-id \u003cprocessInstanceId\u003e --users \"userId1,userId2\" --operator-id \"123123\""
],
"reviewed": false,
"source_refs": [
"internal/cli/schema_mcp_metadata.json#tools.oa.oa_cc_noticer",
"skills/mono/references/products/oa.md",
"skills/mono/schema-hints/selection-review.json",
"skills/mono/schema-hints/sibling-disambiguation.json"
],
"interface_mode": "mcp",
"availability": "available"
},
"oa approval oa-comments": {
"agent_summary": "用户添加审批评论",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"13. 对审批实例添加评论(processInstanceId 来自 list-pending 或 detail)",
"评论审批/添加评论/写评论"
],
"avoid_when": [
"要“同意审批”请改用 dws oa approval approve",
"要“获取员工已处理任务列表”请改用 dws oa approval list-executed",
"要“获取抄送用户的列表”请改用 dws oa approval list-cc"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"examples": [
"dws oa approval oa-comments --instance-id \u003cprocessInstanceId\u003e --content \"同意,请尽快处理\"",
"dws oa approval oa-comments --instance-id \u003cprocessInstanceId\u003e --content \"同意,请尽快处理\" --format json"
],
"reviewed": false,
"source_refs": [
"internal/cli/schema_mcp_metadata.json#tools.oa.dingflow_comments",
"skills/mono/references/products/oa.md",
"skills/mono/schema-hints/selection-review.json",
"skills/mono/schema-hints/sibling-disambiguation.json"
],
"interface_mode": "mcp",
"availability": "available"
},
"oa approval records": {
"agent_summary": "获取审批操作记录",
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
"use_when": [
"6. 查看审批操作记录",
"审批记录/操作历史"
],
"avoid_when": [
"要“同意审批”请改用 dws oa approval approve",
"要“用户添加审批评论”请改用 dws oa approval oa-comments",
"要“获取员工已处理任务列表”请改用 dws oa approval list-executed"
],
"effect": "read",
"effect_source": "command-verb",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws oa approval records --instance-id \u003cprocessInstanceId\u003e",
"dws oa approval records --instance-id \u003cprocessInstanceId\u003e --format json"
],
"source_refs": [
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.get_processInstance_records",
"skills/mono/references/products/oa.md",
"skills/mono/schema-hints/imported/wukong.json",
"skills/mono/schema-hints/selection-review.json",
"skills/mono/schema-hints/sibling-disambiguation.json"
],
"interface_ref": {
"product_id": "oa",
"rpc_name": "get_processInstance_records"
},
"interface_mode": "mcp",
"availability": "available"
},
"oa approval redirect-task": {
"agent_summary": "转交审批任务",
"agent_summary_source": "mcp-tools-list+cli-registry@4574f7022c32",
"use_when": [
"12. 转交审批任务(taskId 来自 tasks,toActionerId 来自 contact user search)",
"转交审批/转交任务"
],
"avoid_when": [
"要“同意审批”请改用 dws oa approval approve",
"要“用户添加审批评论”请改用 dws oa approval oa-comments",
"要“获取员工已处理任务列表”请改用 dws oa approval list-executed"
],
"effect": "write",
"effect_source": "command-verb",
"risk": "medium",
"confirmation": "not_required",
"idempotency": "unknown",
"examples": [
"dws oa approval redirect-task --task-id \u003ctaskId\u003e --to-actioner-id \u003cuserId\u003e",
"dws oa approval redirect-task --task-id \u003ctaskId\u003e --to-actioner-id \u003cuserId\u003e --remark \"请帮忙处理\""
],
"reviewed": false,
"source_refs": [
"internal/cli/schema_mcp_metadata.json#tools.oa.redirect_task",
"skills/mono/references/products/oa.md",
"skills/mono/schema-hints/selection-review.json",
"skills/mono/schema-hints/sibling-disambiguation.json"
],
"interface_mode": "mcp",
"availability": "available"
},
"oa approval reject": {
"agent_summary": "拒绝审批",
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
"use_when": [
"4b. 拒绝审批",
"拒绝审批/驳回"
],
"avoid_when": [
"要“同意审批”请改用 dws oa approval approve",
"要“用户添加审批评论”请改用 dws oa approval oa-comments",
"要“获取员工已处理任务列表”请改用 dws oa approval list-executed"
],
"effect": "destructive",
"effect_source": "skill-explicit",
"risk": "high",
"confirmation": "user_required",
"idempotency": "unknown",
"examples": [
"dws oa approval reject --instance-id \u003cid\u003e --task-id \u003ctaskId\u003e --remark \"不同意\"",
"dws oa approval reject --instance-id \u003cid\u003e --task-id \u003ctaskId\u003e --remark \"不符合要求\" --format json"
],
"source_refs": [
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.reject_processInstance",
"skills/mono/SKILL.md",
"skills/mono/references/products/oa.md",
"skills/mono/references/products/simple.md",
"skills/mono/schema-hints/imported/wukong.json",
"skills/mono/schema-hints/selection-review.json",
"skills/mono/schema-hints/sibling-disambiguation.json"
],
"interface_ref": {
"product_id": "oa",
"rpc_name": "reject_processInstance"
},
"interface_mode": "mcp",
"availability": "available"
},
"oa approval revoke": {
"agent_summary": "撤销已发起的审批",
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
"use_when": [
"5. 撤销自己发起的审批",
"撤回审批/取消审批",
"撤销审批/撤回"
],
"avoid_when": [
"要“同意审批”请改用 dws oa approval approve",
"要“用户添加审批评论”请改用 dws oa approval oa-comments",
"要“获取员工已处理任务列表”请改用 dws oa approval list-executed"
],
"effect": "write",
"effect_source": "skill-explicit",
"risk": "high",
"confirmation": "user_required",
"idempotency": "unknown",
"examples": [
"dws oa approval revoke --instance-id \u003cinstance-id\u003e"
],
"source_refs": [
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.revoke_processInstance",
"skills/mono/SKILL.md",
"skills/mono/references/products/oa.md",
"skills/mono/references/products/simple.md",
"skills/mono/schema-hints/imported/wukong.json",
"skills/mono/schema-hints/selection-review.json",
"skills/mono/schema-hints/sibling-disambiguation.json"
],
"interface_ref": {
"product_id": "oa",
"rpc_name": "revoke_processInstance"
},
"interface_mode": "mcp",
"availability": "available"
},
"oa approval tasks": {
"agent_summary": "查询待我审批的任务 ID",
"agent_summary_source": "dws-wukong-envelope@4574f7022c32",
"use_when": [
"3. 获取待审批任务 ID — 提取 taskId",
"同意审批/批准",
"我有哪些待审的任务",
"拒绝审批/驳回"
],
"avoid_when": [
"要“同意审批”请改用 dws oa approval approve",
"要“用户添加审批评论”请改用 dws oa approval oa-comments",
"要“获取员工已处理任务列表”请改用 dws oa approval list-executed"
],
"effect": "read",
"effect_source": "command-verb",
"risk": "low",
"confirmation": "not_required",
"idempotency": "idempotent",
"examples": [
"dws oa approval tasks --instance-id \u003cprocessInstanceId\u003e",
"dws oa approval tasks --instance-id \u003cprocessInstanceId\u003e --format json"
],
"source_refs": [
"dws-wukong-envelope@4574f7022c32:dws-wukong-discovery.oa.prod.json#oa.list_pending_tasks",
"skills/mono/references/products/oa.md",
"skills/mono/schema-hints/imported/wukong.json",
"skills/mono/schema-hints/selection-review.json",
"skills/mono/schema-hints/sibling-disambiguation.json"
],
"interface_ref": {
"product_id": "oa",
"rpc_name": "list_pending_tasks"
},
"interface_mode": "mcp",
"availability": "available"
}
}
}