
Dws
独立脑图的带内容创建与主题读写使用 dws mind;空白脑图走 wiki,听记内置思维导图走 minutes。...
Install
npx skills add DingTalk-Real-AI/dingtalk-workspace-cli --skill dws -g -a claude-code -y- Repository
- DingTalk-Real-AI/dingtalk-workspace-cli3.9k
- Category
- Engineering
- Updated
- 6d ago
- License
- Apache-2.0
- Context cost
- Mediumabout 3,000 tokens
- Runs scripts
- Yes, review before use
What it does
独立脑图的带内容创建与主题读写使用 dws mind;空白脑图走 wiki,听记内置思维导图走 minutes。 管理钉钉产品能力(Agoal目标管理/AI表格/AI搜问/日历/通讯录/群聊与机器人/待办/审批/法务智能合同/考勤/日志/DING消息/开放平台文档/钉钉文档/钉钉云盘/原生Markdown文件/AI听记/邮箱/在线电子表格/知识库等)。当用户需要查询战略解码、经营合约字段、目标规则周期、个人目标、目标模板或周月报规则的按时/迟交/未提交统计与跟催,操作表格数据、管理日程会议、模糊找人/查谁负责某事项、查询通讯录、管理群聊、机器人发消息、创建待办、提交审批、查询或创建合同台账、批量导入合同、按听记起草合同、归档合同、管理合同项目/相对方/账款、查看考勤、提交日报周报(钉钉日志模版)、读写钉钉文档、上传下载云盘文件、读取或修改原生.md文件、查询听记纪要、收发邮件、读写在线电子表格(axls)、管理钉钉知识库,或订阅个人 IM、OA 审批、VoIP 通话邀请、待办或互动卡片回调事件、实时监听群成员加入、群成员退出、群改名和群解散、审批实例发起/抄送/终止/完成、审批任务创建/完成/转交、VoIP 通话邀请、待办创建/更新/删除,以及互动卡片回调时使用。周报/月报正文填报属于日志 Report;规则级提交统计、迟交、未提交和跟催属于 Agoal。
钉钉全产品 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 帮助负责声明当前版本真正可调用的命令。
