Dws

钉钉全产品 Skill

通过 dws 命令管理钉钉产品能力。

严格禁止 (NEVER DO)

• 不要使用 dws 命令以外的方式操作（禁止 curl、HTTP API、浏览器）
• 不要编造 UUID、ID 等标识符，必须从命令返回中提取
• 不要猜测字段名/参数值，操作前必须先查询确认

严格要求 (MUST DO)

• 所有命令必须加 --format json 以获取可解析输出
• 删除操作前必须加 --yes 并和用户确认
• 单次批量操作不超过 100 条记录
• 所有命令必须严格遵循对应产品参考文档里面规定的参数格式（如：如果有参数值，则参数和参数值之间至少用一个空格隔开）

产品总览

意图判断决策树

用户提到"表格/多维表/AI表格/记录/数据" → aitable 用户提到"日程/日历/会议室/约会" → calendar 用户提到"通讯录/同事/部门/组织架构" → contact 用户提到"文档/知识库/写文档" → doc 用户提到"待办/TODO/任务提醒" → todo 用户提到"邮件/邮箱" → mail 用户提到"听记/会议录音/转写/AI摘要以及用户传入听记URL（如 https://shanji.dingtalk.com/*）" → minutes 用户提到"帮我做/建/生成/生成系统/AI应用/创建应用/智能应用" → aiapp 用户提到"DING/紧急消息/电话提醒" → ding 用户提到"考勤/打卡/排班" → attendance 用户提到"群聊/群消息/群成员/聊天记录/建群/机器人发消息/Webhook/通知" → chat 用户提到"审批/OA" → oa 用户提到"开发/API/调用错误 文档" → devdoc 用户提到“校招/发布职位/我的候选人” → ai_sincere_hire 用户提到"视频会议/预约会议" → conference 用户提到"直播" → live 用户提到"日志/日报/周报/日志统计" → report 用户提到"钉盘/文件/网盘/下载文件/上传文件" → drive 用户提到"企业信用/工商信息/股东/裁判文书/风险/商标/专利/招投标/联系方式/KP" → credit 用户提到"法律咨询/法规/案例/法条/判例/法律依据" → law

关键区分: aitable(数据表格) vs doc(文档编辑) 关键区分: report(钉钉日志/日报周报) vs doc(文档编辑) vs todo(待办任务) 关键区分: drive(钉盘文件存储/上传/下载) vs doc(钉钉文档内容读写/知识库空间) 关键区分: conference(视频会议预约) vs calendar event(日历日程管理) 关键区分: chat message send(个人身份群发) vs send-by-bot(机器人发消息) vs send-by-webhook(Webhook告警)

更多易混淆场景及用户表达示例，见 intent-guide.md

核心流程

作为一个智能助手，你的首要任务是理解用户的真实、完整的意图，而不是简单地执行命令。在选择 dws 的产品命令前，必须严格遵循以下三步流程：

1. 意图分类：首先，判断用户指令的核心 动词/动作 属于哪一类。这比关注名词更重要。
2. 歧义处理与信息追问：如果用户指令模糊或包含多个产品的关键字，严禁猜测。必须主动向用户追问以澄清意图。这是你作为智能助手而非命令执行器的核心价值。
3. 精准产品映射：在完成前两步，意图已经清晰后，参考产品总览和意图判断决策树 来选择产品。
4. 充分阅读产品参考文件，通过编写代码或直接调用指令实现用户意图。

错误处理

1. 遇到错误，加 --verbose 重试一次
2. 仍然失败，报告错误信息给用户
3. 禁止自行尝试替代方案
4. 如果出现身份校验失败，可以使用 dws auth login 进行登录

详细参考 (按需读取)

• references/products/ — 各产品命令详细参考
• references/intent-guide.md — 意图路由指南（易混淆场景对照）
• references/global-reference.md — 全局标志、认证、输出格式
• references/field-rules.md — AI表格字段类型规则
• references/error-codes.md — 错误码 + 调试流程
• scripts/ — AI表格批量操作脚本