Dws
管理钉钉产品能力(Agoal目标管理/AI表格/AI搜问/日历/通讯录/群聊与机器人/待办/审批/法务智能合同/考勤/日志/DING消息/开放平台文档/钉钉文档/钉钉云盘/原生Markdown文件/AI听记/邮箱/在线电子表格/知识库等)。当用户需要查询战略解码、经营合约字段、目标规则周期、个人目标、目标模板或周月报规则的按时/迟交/未提交统计与跟催，操作表格数据、管理日程会议、模糊找人/查谁负责某事项、查询通讯录、管理群聊、机器人发消息、创建待办、提交审批、查询或创建合同台账、批量导入合同、按听记起草合同、归档合同、管理合同项目/相对方/账款、查看考勤、提交日报周报（钉钉日志模版）、读写钉钉文档、上传下载云盘文件、读取或修改原生.md文件、查询听记纪要、收发邮件、读写在线电子表格(axls)、管理钉钉知识库，或订阅个人 IM、OA 审批、VoIP 通话邀请、待办或互动卡片回调事件、实时监听群成员加入、群成员退出、群改名和群解散、审批实例发起/抄送/终止/完成、审批任务创建/完成/转交、VoIP 通话邀请、待办创建/更新/删除，以及互动卡片回调时使用。周报/月报正文填报属于日志 Report；规则级提交统计、迟交、未提交和跟催属于 Agoal。
Specification
- Skill ID
- dingtalk-real-ai/dingtalk-workspace-cli/dws
- Publisher
- dingtalk-real-ai
- Repository
- dingtalk-workspace-cli
- Installs
- 0
- Files
- 187
- Synced
- Sep 23, 2026
How to use it
Open any RiverX project, open the Skills panel in the chat, and search for this identifier. The files are fetched from the source repository at install time.
dingtalk-real-ai/dingtalk-workspace-cli/dwsInstalls these files- LICENSE
- NOTICE
- SKILL.md
- references/best_practices/01-messaging.md
- references/best_practices/02-task.md
- references/best_practices/03-meeting.md
- references/best_practices/04-document.md
- references/best_practices/05-reporting.md
- references/best_practices/06-data-analytics.md
- references/best_practices/07-minutes.md
- references/best_practices/08-directory.md
- references/best_practices/09-mail.md
- references/best_practices/10-minutes-speaker-match.md
- references/best_practices/11-minutes-speaker-correct.md
- references/best_practices/_common/conventions.md
- references/best_practices/_common/recipe-conventions.md
- references/best_practices/lite-recipes.md
- references/capability-limits.md
- references/channel-login.md
- references/error-codes.md
- references/field-rules.md
- references/global-reference.md
- references/intent-guide.md
- references/products/agoal.md
- references/products/aisearch.md
- references/products/aitable-record-ops.md
- references/products/aitable.md
- references/products/aitable/aitable-advperm.md
- references/products/aitable/aitable-attachment.md
- references/products/aitable/aitable-best-practices.md
- references/products/aitable/aitable-cell-value.md
- references/products/aitable/aitable-comment.md
- references/products/aitable/aitable-dashboard-chart.md
- references/products/aitable/aitable-data-analysis-sop.md
- references/products/aitable/aitable-error-recovery.md
- references/products/aitable/aitable-export-import.md
- references/products/aitable/aitable-field-properties.md
- references/products/aitable/aitable-field.md
- references/products/aitable/aitable-filter-sort.md
- references/products/aitable/aitable-form.md
- references/products/aitable/aitable-formula-guide.md
- references/products/aitable/aitable-primary-doc.md
- references/products/aitable/aitable-psql.md
- references/products/aitable/aitable-record-create.md
- references/products/aitable/aitable-record-delete.md
- references/products/aitable/aitable-record-history.md
- references/products/aitable/aitable-record-name-key.md
- references/products/aitable/aitable-record-query.md
- references/products/aitable/aitable-record-share.md
- references/products/aitable/aitable-record-stats.md
- references/products/aitable/aitable-record-update.md
- references/products/aitable/aitable-record-upsert.md
- references/products/aitable/aitable-view-config.md
- references/products/aitable/aitable-view-extras.md
- references/products/aitable/aitable-workflow.md
- references/products/attendance-report.md
- references/products/attendance-schedule.md
- references/products/attendance-vacation.md
- references/products/attendance.md
- references/products/calendar.md
- references/products/chat-emoji-list.md
- references/products/chat.md
- references/products/chat/a2ui.md
- references/products/contact.md
- references/products/contract.md
- references/products/dev.md
- references/products/devdoc.md
- references/products/ding.md
- references/products/dingtalk-tag/capability.md
- references/products/dingtalk-tag/dingtalk-tag-index.md
- references/products/dingtalk-tag/manage-and-connect.md
- references/products/dingtalk-tag/manage.md
- references/products/dingtalk-tag/run.md
- references/products/doc.md
- references/products/doc/doc-block.md
- references/products/doc/doc-comment.md
- references/products/doc/doc-create.md
- references/products/doc/doc-export.md
- references/products/doc/doc-file-ops.md
- references/products/doc/doc-import.md
- references/products/doc/doc-info.md
- references/products/doc/doc-list.md
- references/products/doc/doc-media.md
- references/products/doc/doc-permission.md
- references/products/doc/doc-read.md
- references/products/doc/doc-search.md
- references/products/doc/doc-update.md
- references/products/doc/doc-whiteboard.md
- references/products/doc/format/doc-jsonml-cookbook.md
- references/products/doc/format/doc-jsonml-schema.json
- references/products/doc/format/doc-jsonml-schema.md
- references/products/doc/style/doc-create-workflow.md
- references/products/doc/style/doc-style-guideline.md
- references/products/doc/style/doc-update-workflow.md
- references/products/drive.md
- references/products/drive/drive-export.md
- references/products/drive/drive-storage.md
- references/products/drive/drive-task.md
- references/products/event.md
- references/products/hrbrain.md
- references/products/html.md
- references/products/mail.md
- references/products/markdown.md
- references/products/minutes.md
- references/products/oa.md
- references/products/oa/oa-form-components.md
- references/products/oa/oa-goout.md
- references/products/oa/oa-leave.md
- references/products/oa/oa-overtime.md
- references/products/oa/oa-process-nodes.md
- references/products/oa/oa-supply.md
- references/products/openapi-explorer.md
- references/products/pat.md
- references/products/recruit.md
- references/products/report.md
- references/products/sheet.md
- references/products/sheet/sheet-batch-operations.md
- references/products/sheet/sheet-chart.md
- references/products/sheet/sheet-comment.md
- references/products/sheet/sheet-conditional-format.md
- references/products/sheet/sheet-dimension-operations.md
- references/products/sheet/sheet-dropdown.md
- references/products/sheet/sheet-export.md
- references/products/sheet/sheet-filter-view.md
- references/products/sheet/sheet-filter.md
- references/products/sheet/sheet-formula.md
- references/products/sheet/sheet-import.md
- references/products/sheet/sheet-media-image.md
- references/products/sheet/sheet-pivot-table.md
- references/products/sheet/sheet-range-operations.md
- references/products/sheet/sheet-read-data.md
- references/products/sheet/sheet-revision-changeset.md
- references/products/sheet/sheet-search-replace.md
- references/products/sheet/sheet-style-format.md
- references/products/sheet/sheet-version.md
- references/products/sheet/sheet-workbook.md
- references/products/sheet/sheet-write-data.md
- references/products/simple.md
- references/products/todo.md
- references/products/whiteboard.md
- references/products/whiteboard/compose.md
- references/products/whiteboard/diff.md
- references/products/whiteboard/open-nodes-v1.md
- references/products/whiteboard/open-nodes-v1/01-overview.md
- references/products/whiteboard/open-nodes-v1/02-query.md
- references/products/whiteboard/open-nodes-v1/03-update.md
- references/products/whiteboard/open-nodes-v1/04-text-style.md
- references/products/whiteboard/open-nodes-v1/05-shape-frame-group-connector.md
- references/products/whiteboard/open-nodes-v1/06-vector-icon-path.md
- references/products/whiteboard/open-nodes-v1/07-examples-errors-write-support.md
- references/products/whiteboard/open-nodes-v1/08-catalogs.md
- references/products/whiteboard/render.md
- references/products/whiteboard/replace.md
- references/products/whiteboard/vector.md
- references/products/wiki.md
- references/url-patterns.md
- scripts/aitable_export_via_task.py
- scripts/aitable_import_via_task.py
- scripts/attendance_my_record.py
- scripts/attendance_report_checkin.py
- scripts/attendance_report_common.py
- scripts/attendance_report_daily.py
- scripts/attendance_report_detail.py
- scripts/attendance_report_monthly.py
- scripts/attendance_report_record.py
- scripts/attendance_schedule_export.py
- scripts/attendance_schedule_import.py
- scripts/attendance_team_shift.py
- scripts/attendance_vacation_balance.py
- scripts/bulk_add_fields.py
- scripts/calendar_free_slot_finder.py
- scripts/calendar_schedule_meeting.py
- scripts/calendar_today_agenda.py
- scripts/contact_dept_members.py
- scripts/drive_tree_list.py
- scripts/import_records.py
- scripts/mail_send_with_cc.py
- scripts/mail_unread_summary.py
- scripts/minutes_recent_summary.py
- scripts/oa_batch_approve.py
- scripts/oa_pending_review.py
- scripts/report_inbox_today.py
- scripts/report_received_today.py
- scripts/todo_batch_create.py
- scripts/todo_daily_summary.py
- scripts/todo_overdue_check.py
- scripts/upload_attachment.py
What this skill tells the agent
钉钉全产品 Skill
通过 dws 命令管理钉钉产品能力。
命令可用性以当前 dws 二进制为准。本文档随内置 skill 发布，可能滞后于二进制；如果dws <cmd> --help不存在，说明当前版本未暴露该命令。--help决定 Cobra 实际接受的 flags；公开基础命令和内建+shortcut 的 leaf Schema（常规用--compact）决定 Agent 选择、参数/约束和安全确认语义。实际调用前可用dws <cmd> --help或--dry-run验证。
严格禁止 (NEVER DO)
- 不要使用 dws 命令以外的方式操作钉钉业务数据（禁止 curl 或自行拼 HTTP）；唯一例外是按 openapi-explorer.md 读取官方
open.dingtalk.com/llms.txt文档并生成受限的dws api调用 - 不要编造 UUID、ID 等标识符，必须从命令返回中提取
- 不要猜测字段名/参数值，操作前必须先查询确认
严格要求 (MUST DO)
- 所有命令必须加
--format json以获取可解析输出 - 用户明确要登录钉钉国际版、海外版或
.io区域时，必须执行dws auth login --intl（无头环境再加--device），不得回退到国内.com；--intl只用于登录，后续业务命令按所选 profile 自动路由 - 危险操作必须先向用户确认，用户同意后才加
--yes执行 - 单次批量操作不超过 30 条记录
- 所有命令必须严格遵循对应产品参考文档里面规定的参数格式（如：如果有参数值，则参数和参数值之间至少用一个空格隔开）
- 脚本只用于明确覆盖的复合任务：scripts/ 下的脚本可封装 AI 表格批量导入导出、AI 应用创建轮询、文档创建后写内容、钉盘目录树等流程；当公开
+Shortcut 已提供目标唯一解析、分页/部分失败 ledger 和确认语义时，优先 Shortcut。Chat 历史导出与机器人广播已完全下沉 Runtime，不再发布兼容脚本 - 实时个人事件例外：普通 IM 消息、reaction、已读和撤回默认走
dws event +listen-im ...；OA 审批、VoIP 通话邀请、Todo、互动卡片回调、群生命周期、明确的原始 EventKey、Filter DSL、subscribe_id 或原始 envelope 使用dws event consume ... --flatten。不要写脚本轮询消息历史、审批列表、通话记录或待办列表
Shortcut 与原子命令的使用原则
shortcut 是对常用操作的高层封装，适合优先承担用户意图；产品参考文档和本 skill 负责判断意图、风险、跨产品流程和复杂参数，CLI 帮助负责声明当前版本真正可调用的命令。
- 先按产品参考、意图表和 recipe 路由。用户意图可由可见 Shortcut 满足时，优先使用
dws <service> +<verb> ... --format json，不要手写等价的多步原子命令。只有脚本明确补足 Shortcut 未覆盖的复合交付物且其安全/完整性契约仍适用时才选择脚本。 - 公开内建 shortcut 同时进入 Runtime Schema。用
dws schema --cli-path "<service> +<verb>" --compact --format json读取 Agent 选择、参数、跨参数约束和 risk/confirmation；只有参数映射、接口绑定或 provenance 审计才通过--jq精确读取 full leaf；dws shortcut list --service <service> --format json只作为轻量批量发现入口。 - 真正组装参数前用叶子帮助
dws <service> +<verb> --help核对当前 Cobra 接受的 flags。父级dws <service> --help只能发现子命令，不能替代叶子参数帮助。 - shortcut catalog 中
confirmation=user_required时，必须先获得用户确认，确认后才加--yes；not_required不额外确认。 - 如果 shortcut 不在 help / list 中，改用产品参考里的原子命令、脚本或标准流程；不要猜测未展示的
+命令。 - shortcut 失败时按“错误处理”流程先加
--verbose复查；若仍失败，应记录具体输入、输出、trace / endpoint / tool 信息。
<!-- VISIBLE_SHORTCUTS_OVERVIEW_START -->
Shortcut 总览
下面只统计当前公开 catalog 中的 shortcut，不展开完整明细。已知意图先按产品 Skill、意图表或任务 reference 选唯一命令；参数/约束/安全不明时读一次 leaf 窄 Schema。Schema 不可用时才读一次已知 leaf Help；unknown flag 用同 leaf Help 修正一次；unknown command 不查 Help，先用错误的明确 suggestion，否则用已加载 Skill/reference 的明确兼容入口，仍无则报告漂移，不枚举全 Catalog。仅当现有路由和 reference 都无法定位低频能力时，才用 dws shortcut list --service <service> --format json 做最后回退；不要为已知意图加载完整产品 Catalog 或 root/parent Help。
| 服务 | shortcut 数 | multi skill |
|---|---|---|
agoal | 5 | — |
aisearch | 1 | — |
aitable | 126 | dingtalk-aitable |
attendance | 11 | dingtalk-misc |
calendar | 27 | dingtalk-calendar |
chat | 102 | dingtalk-chat |
contact | 13 | dingtalk-contact |
devapp | 25 | dingtalk-misc |
ding | 1 | dingtalk-misc |
doc | 49 | dingtalk-doc |
drive | 28 | dingtalk-drive |
mail | 8 | dingtalk-mail |
minutes | 29 | dingtalk-minutes |
oa | 1 | dingtalk-misc |
pat | 1 | dingtalk-misc |
report | 4 | dingtalk-misc |
sheet | 2 | dingtalk-misc |
todo | 21 | dingtalk-todo |
whiteboard | 3 | dingtalk-misc |
wiki | 20 | dingtalk-wiki |
<!-- VISIBLE_SHORTCUTS_OVERVIEW_END -->
多组织 / 多账号
dws profile list --format json默认返回全部账号。自动化只使用每项稳定的profile=corpId:userId；status/expiresAt/refreshExpAt来自真实身份 Token，列表不触发刷新。- 输入支持
corpId:userId、corpId:userName、corpName:userId、corpName:userName，也兼容单独的 corpId、唯一 corpName 和本地 profile 名。名称只用于输入；重名时必须按报错候选改用corpId:userId。 - 只传组织时使用该组织明确记录的
isOrgCurrent=true账号。多账号组织没有默认账号时必须让用户指定账号；禁止选择第一项、最近登录或最近使用账号。 - 不传
--profile使用全局isCurrent=true账号。primaryProfile/isPrimary仅兼容输出，不参与选择；previousProfile只用于profile switch -。 - 跨组织读 / 搜：按
corpId去重；每个组织使用唯一isOrgCurrent=true的profile。组织存在多个账号且没有默认账号时先询问用户。写 / 发 / 删 / 撤回及持久切换前先确认目标组织和账号。
产品总览
| 产品 | 用途 | 参考文件 |
|---|---|---|
agoal | 目标管理：战略解码、经营合约、计分卡、目标规则周期、个人目标、目标模板、周月报规则提交统计与跟催 | agoal.md |
aisearch | AI搜问（通用找人首选）：按姓名/部门/职位/职责/上级/下级/手机号/工号维度找人，"谁负责 XX/XX 的负责人/某事项/某项目的人"统一走本产品；不含人才池/绩效/职业历程等专项 HR 场景（那些去 hrbrain） | aisearch.md |
aitable | AI表格：Base/数据表/字段/记录/视图/附件/图表/仪表盘/导入导出/模板搜索/PostgreSQL 只读查询与 JOIN | aitable.md |
api | OpenAPI 逃生舱：官方 llms.txt 分层发现，仅执行企业内部应用 App Token 服务端 API | openapi-explorer.md |
attendance | 考勤：打卡结果/打卡流水/考勤组查询/考勤规则/汇总统计/假期类型/假期余额（P0 已落地，部分管理类命令仍属 P1） | attendance.md |
calendar | 日历：日历列表/日程/参与者/附件/响应/会议室/闲忙查询/时间建议 | calendar.md |
chat | 群聊与机器人：搜索群/建群/群成员管理/改群名/消息发送(文本/Markdown/图片/文件)/拉取消息/消息收藏/@我/特别关注/机器人群发/单聊/撤回/转发/引用回复/Webhook/机器人搜索 | chat.md |
contact | 通讯录：用户查询/部门/角色/花名册（学历/家庭/银行卡/紧急联系人/合同等基础字段）/离职员工/特别关注，以及创建企业、企业账号和邀请员工；不含职业历程/绩效/人才池（那些去 hrbrain） | contact.md |
contract | 法务智能合同：台账、批量导入、听记起草、归档、项目、相对方与账款管理 | contract.md |
devdoc | 开放平台文档：搜索开发文档 | devdoc.md |
ding | DING消息：发送/撤回（应用内/短信/电话） | ding.md |
dingtalk-tag | DingTalk Tag 数字员工：管理生命周期、Skill/MCP、执行状态与 trace，以及员工 Profile、普通本地 Agent 或 DSH 接入与运行管理 | dingtalk-tag-index.md |
doc | 钉钉文档：搜索/浏览/读写/块级编辑/评论/文件创建/复制/移动/重命名/删除/导出 docx/权限管理/媒体上传下载 | doc.md |
drive | 钉钉云盘：文件列表/元数据/文件夹/上传(两步)/下载/本地与钉盘文件夹差异比较(status)/拉取到本地(pull)/推送到钉盘(push)/双向同步(sync)/互联网公开发布(publish)/分享链接密码与有效期 | drive.md |
hrbrain | 组织大脑：人才池管理/员工档案专项模块查询（元数据/批量数据/标签/职业历程/绩效）/结构化高级人才搜索（原始条件表达式）；区别于 contact 的基础通讯录档案与 aisearch 的通用语义找人 | hrbrain.md |
html | 原生 HTML 文件：读取/创建/全量覆盖/局部替换（.html/.htm，钉盘或文档空间） | html.md |
markdown | 原生 Markdown 文件：读取/创建/对比/全量覆盖/局部替换/评论列表 | markdown.md |
minutes | AI听记：听记列表/摘要/关键词/转写/待办/思维导图/发言人/发言人段落总结/热词/录音控制/成员权限/上传 | minutes.md |
oa | OA审批：待处理/详情/同意/拒绝/撤销/记录/已发起/任务/转交/评论/抄送 | oa.md |
pat | PAT 行为授权：浏览器策略/scope 预览/一次性、会话或永久授权 | pat.md |
report | 日志：按模版创建/收件箱/已发送/模版查看/详情/已读统计 | report.md |
mail | 邮箱：邮箱地址查询/邮件搜索(KQL)/邮件详情/发送邮件 | mail.md |
sheet | 在线电子表格(axls)：工作表 CRUD/区域读写/CSV 批量写入/行列增删/合并/查找替换/筛选视图/全局筛选/排序/下拉列表/条件格式/浮动图片/浮动图表/模板/导出 xlsx(单命令一站式) | sheet.md |
Use this skill in a project
Open any RiverX project, search the Skills panel for dingtalk-real-ai/dingtalk-workspace-cli/dws, and install it in one click.