dws
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinese钉钉全产品 Skill
DingTalk Full Product Skill
通过 命令管理钉钉产品能力。
dwsManage DingTalk product capabilities via the command.
dws严格禁止 (NEVER DO)
STRICTLY PROHIBITED (NEVER DO)
- 不要使用 dws 命令以外的方式操作（禁止 curl、HTTP API、浏览器）
- 不要编造 UUID、ID 等标识符，必须从命令返回中提取
- 不要猜测字段名/参数值，操作前必须先查询确认
- NEVER use methods other than the dws command for operations (curl, HTTP API, browsers are prohibited)
- NEVER fabricate identifiers like UUID or ID; must extract them from command returns
- NEVER guess field names/parameter values; must query and confirm before operations
严格要求 (MUST DO)
STRICTLY REQUIRED (MUST DO)
- 所有命令必须加 以获取可解析输出
--format json - 删除操作前必须加 并和用户确认
--yes - 单次批量操作不超过 100 条记录
- 所有命令必须严格遵循对应产品参考文档里面规定的参数格式（如：如果有参数值，则参数和参数值之间至少用一个空格隔开）
- All commands must include to get parsable output
--format json - Add and confirm with the user before performing delete operations
--yes - Batch operations must not exceed 100 records at a time
- All commands must strictly follow the parameter formats specified in the corresponding product reference documents (e.g., if there is a parameter value, at least one space must separate the parameter and its value)
产品总览
Product Overview
| 产品 | 用途 | 参考文件 |
|---|---|---|
| AI表格：表格/数据表/字段/记录增删改查/模板搜索 | aitable.md |
| 日历：日程/参与者/会议室/闲忙查询 | calendar.md |
| 通讯录：用户查询(当前用户/搜索/详情)/部门查询(搜索/子部门/成员列表) | contact.md |
| 文档：搜索/浏览/读取/创建/更新文档/文件夹管理/块级编辑 | doc.md |
| 群聊：群管理(建群/搜索/成员增删/改群名)/消息(拉取/发送/机器人群发/Webhook)/机器人搜索 | chat.md |
| 待办：创建(含优先级/截止时间)/查询/修改/标记完成/删除 | todo.md |
| 邮箱：查询邮箱/搜索/查看/发送邮件 | mail.md |
| AI听记：列表/摘要/转写/关键字/标题修改 | minutes.md |
| 日志：收件箱/已发送/模版查看/详情/已读统计 | report.md |
| 钉盘：浏览文件/元数据/下载/创建文件夹/上传文件 | drive.md |
| DING消息：发送/撤回（应用内/短信/电话） | ding.md |
| 开放平台文档：搜索开发文档 | simple.md |
| 视频会议：预约会议 | simple.md |
| AI应用：创建/查询/修改AI应用 | aiapp.md |
| 直播：查看直播列表 | simple.md |
| OA审批：待处理/详情/同意/拒绝/撤销/记录/已发起/任务 | oa.md |
| 考勤：打卡记录/排班查询 | attendance.md |
| Product | Purpose | Reference Document |
|---|---|---|
| AI Table: CRUD operations for tables/data tables/fields/records, template search | aitable.md |
| Calendar: Schedule/participant/conference room/busy-free query | calendar.md |
| Contacts: User queries(current user/search/details)/department queries(search/sub-departments/member lists) | contact.md |
| Documents: Search/browse/read/create/update documents, folder management, block-level editing | doc.md |
| Group Chat: Group management(creation/search/member addition/removal/name modification), messages(pull/send/bot mass sending/Webhook), bot search | chat.md |
| Todo: Creation(with priority/deadline)/query/modification/mark as complete/delete | todo.md |
| Email: Email query/search/view/send | mail.md |
| AI Meeting Minutes: List/summary/transcription/keyword/title modification | minutes.md |
| Work Reports: Inbox/sent/templates view/details/read statistics | report.md |
| DingTalk Drive: Browse files/metadata/download/create folders/upload files | drive.md |
| DING Messages: Send/recall(in-app/SMS/phone call) | ding.md |
| Open Platform Documents: Search development documents | simple.md |
| Video Conference: Schedule conferences | simple.md |
| AI Applications: Create/query/modify AI applications | aiapp.md |
| Live Streaming: View live stream list | simple.md |
| OA Approval: Pending tasks/details/approve/revoke/records/initiated tasks | oa.md |
| Attendance: Check-in records/schedule query | attendance.md |
意图判断决策树
Intent Judgment Decision Tree
用户提到"表格/多维表/AI表格/记录/数据" →
用户提到"日程/日历/会议室/约会" →
用户提到"通讯录/同事/部门/组织架构" →
用户提到"文档/知识库/写文档" →
用户提到"待办/TODO/任务提醒" →
用户提到"邮件/邮箱" →
用户提到"听记/会议录音/转写/AI摘要以及用户传入听记URL（如 ）" →
用户提到"帮我做/建/生成/生成系统/AI应用/创建应用/智能应用" →
用户提到"DING/紧急消息/电话提醒" →
用户提到"考勤/打卡/排班" →
用户提到"群聊/群消息/群成员/聊天记录/建群/机器人发消息/Webhook/通知" →
用户提到"审批/OA" →
用户提到"开发/API/调用错误 文档" →
用户提到“校招/发布职位/我的候选人” →
用户提到"视频会议/预约会议" →
用户提到"直播" →
用户提到"日志/日报/周报/日志统计" →
用户提到"钉盘/文件/网盘/下载文件/上传文件" →
用户提到"企业信用/工商信息/股东/裁判文书/风险/商标/专利/招投标/联系方式/KP" →
用户提到"法律咨询/法规/案例/法条/判例/法律依据" →
aitablecalendarcontactdoctodomailhttps://shanji.dingtalk.com/*minutesaiappdingattendancechatoadevdocai_sincere_hireconferencelivereportdrivecreditlaw关键区分: 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
When the user mentions "table/multi-dimensional table/AI table/record/data" →
When the user mentions "schedule/calendar/conference room/appointment" →
When the user mentions "contacts/colleagues/department/organizational structure" →
When the user mentions "document/knowledge base/write document" →
When the user mentions "todo/TODO/task reminder" →
When the user mentions "mail/email" →
When the user mentions "meeting minutes/conference recording/transcription/AI summary" or provides a meeting minute URL (e.g., ) →
When the user mentions "help me make/build/generate/generate system/AI application/create application/intelligent application" →
When the user mentions "DING/urgent message/phone reminder" →
When the user mentions "attendance/check-in/schedule" →
When the user mentions "group chat/group message/group member/chat history/create group/bot send message/Webhook/notification" →
When the user mentions "approval/OA" →
When the user mentions "development/API/call error document" →
When the user mentions "campus recruitment/post position/my candidates" →
When the user mentions "video conference/schedule conference" →
When the user mentions "live streaming" →
When the user mentions "work report/daily report/weekly report/work report statistics" →
When the user mentions "DingTalk Drive/file/cloud drive/download file/upload file" →
When the user mentions "enterprise credit/industrial and commercial information/shareholders/judicial documents/risk/trademark/patent/bidding/contact information/KP" →
When the user mentions "legal consultation/laws/legal cases/statutes/legal precedents/legal basis" →
aitablecalendarcontactdoctodomailhttps://shanji.dingtalk.com/*minutesaiappdingattendancechatoadevdocai_sincere_hireconferencelivereportdrivecreditlawKey Distinctions: aitable(data tables) vs doc(document editing)
Key Distinctions: report(DingTalk work reports/daily/weekly reports) vs doc(document editing) vs todo(todo tasks)
Key Distinctions: drive(DingTalk Drive file storage/upload/download) vs doc(DingTalk Document content read/write/knowledge base space)
Key Distinctions: conference(video conference scheduling) vs calendar event(calendar schedule management)
Key Distinctions: chat message send(personal identity mass sending) vs send-by-bot(bot message sending) vs send-by-webhook(Webhook alerts)
For more confusing scenarios and user expression examples, see intent-guide.md
核心流程
Core Process
作为一个智能助手，你的首要任务是理解用户的真实、完整的意图，而不是简单地执行命令。在选择 的产品命令前，必须严格遵循以下三步流程：
dws- 意图分类：首先，判断用户指令的核心 动词/动作 属于哪一类。这比关注名词更重要。
- 歧义处理与信息追问：如果用户指令模糊或包含多个产品的关键字，严禁猜测。必须主动向用户追问以澄清意图。这是你作为智能助手而非命令执行器的核心价值。
- 精准产品映射：在完成前两步，意图已经清晰后，参考产品总览和意图判断决策树 来选择产品。
- 充分阅读产品参考文件，通过编写代码或直接调用指令实现用户意图。
As an intelligent assistant, your primary task is to understand the user's true and complete intent, rather than simply executing commands. Before selecting a product command, you must strictly follow these three steps:
dws- Intent Classification: First, determine which category the core verb/action in the user's instruction belongs to. This is more important than focusing on nouns.
- Ambiguity Handling and Information Inquiry: If the user's instruction is ambiguous or contains keywords from multiple products, under no circumstances should you guess. You must actively ask the user to clarify their intent. This is your core value as an intelligent assistant rather than a command executor.
- Accurate Product Mapping: After completing the first two steps and clarifying the intent, refer to the Product Overview and Intent Judgment Decision Tree to select the appropriate product.
- Fully read the product reference documents, and implement the user's intent by writing code or directly calling commands.
错误处理
Error Handling
- 遇到错误，加 重试一次
--verbose - 仍然失败，报告错误信息给用户
- 禁止自行尝试替代方案
- 如果出现身份校验失败，可以使用 dws auth login 进行登录
- When encountering an error, retry once with
--verbose - If it still fails, report the error message to the user
- Prohibit trying alternative solutions on your own
- If identity verification fails, you can use dws auth login to log in
详细参考 (按需读取)
Detailed References (Read on Demand)
- references/products/ — 各产品命令详细参考
- references/intent-guide.md — 意图路由指南（易混淆场景对照）
- references/global-reference.md — 全局标志、认证、输出格式
- references/field-rules.md — AI表格字段类型规则
- references/error-codes.md — 错误码 + 调试流程
- scripts/ — AI表格批量操作脚本
- references/products/ — Detailed reference for each product command
- references/intent-guide.md — Intent routing guide (comparison of confusing scenarios)
- references/global-reference.md — Global flags, authentication, output format
- references/field-rules.md — AI Table field type rules
- references/error-codes.md — Error codes + debugging process
- scripts/ — AI Table batch operation scripts