用途:面向钉钉 OA 审批场景,当用户提及 OA、审批、待处理审批、同意/拒绝/撤销审批、已发起审批、审批记录或批量审批时使用。与 dingtalk-todo(待办任务)、dingtalk-report(日志)职责区分。命令前缀为 dws oa。
使用前提:先阅读 dws-shared skill,了解鉴权、全局参数、产品路由、URL 预检、错误码与安全规则;dws 二进制需在 PATH 中。命令可用性以当前 dws 二进制为准,服务发现已下线,若 dws <cmd> --help 不存在则说明该版本未暴露该命令。调用前可用 dws <cmd> --help 或 --dry-run 验证。
主要能力与用法:
- 待我处理:python scripts/oa_pending_review.py --days 7
- 审批详情:dws oa approval detail --instance-id <processInstanceId>
- 同意/拒绝:dws oa approval approve --instance-id <id> --task-id <taskId> 或 reject,后者需加 --remark "<原因>",且需用户确认
- 批量审批:python scripts/oa_batch_approve.py --action approve --days 7
- 撤销:dws oa approval revoke --instance-id <id>
- 已发起:dws oa approval list-initiated --process-code <code> --start "<ISO-8601>",processCode 来自 dws oa approval list-forms
Shortcut(无专用脚本/recipe 时优先):dws oa +list-cc(抄送我的审批)、+list-executed(我已处理的)、+list-forms(可见表单)、+list-pending(待我处理,时间范围为 epoch 毫秒)、+list-submitted、+my-initiated、+search-forms。用 dws shortcut list --service oa --format json 读取参数与风险,用 dws oa <shortcut> --help 核对 flags;不要对 + 路径调用 dws schema。
限制与风险:approval approve / reject 不可撤回,必须先展示摘要并获得用户明确同意,再加 --yes。multi 模式当前未达 stable 标准,生产或共享环境建议使用 mono 模式(dws skill setup --mode mono)。跨产品协作:催别人审批应在群里 @对方(dingtalk-chat);审批通过后建待办切到 dingtalk-todo。其余细节暂未提供。