玉澜andCursor
5856a897d1
Own safety/gates/parameters in metadata/ and Agent prose in selection/, drop the monolithic Manual file, and keep confirmation aligned with per-tool runtime_gate. Co-authored-by: Cursor <cursoragent@cursor.com>
382 lines
18 KiB
JSON
382 lines
18 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"
|
|
]
|
|
}
|
|
},
|
|
"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"
|
|
]
|
|
}
|
|
}
|
|
}
|