{
  "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"
      ]
    }
  }
}