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 to operate (prohibit curl, HTTP API, browsers)
- Never fabricate identifiers like UUID or ID; must extract them from command returns
- Never guess field names/parameter values; must query and confirm before operation
严格要求 (MUST DO)
STRICTLY REQUIRED (MUST DO)
- 所有命令必须加 以获取可解析输出
--format json - 危险操作必须先向用户确认，用户同意后才加 执行
--yes - 单次批量操作不超过 30 条记录
- 所有命令必须严格遵循对应产品参考文档里面规定的参数格式（如：如果有参数值，则参数和参数值之间至少用一个空格隔开）
- All commands must include to get parsable output
--format json - Dangerous operations must be confirmed with the user first; add to execute only after user consent
--yes - Batch operations cannot exceed 30 records at a time
- All commands must strictly follow the parameter formats specified in the corresponding product reference documents (e.g., if there are parameter values, there must be at least one space between the parameter and its value)
产品总览
Product Overview
| 产品 | 用途 | 参考文件 |
|---|---|---|
| AI表格：表格/数据表/字段/记录增删改查/模板搜索 | aitable.md |
| 审批：审批表单/发起实例/审批/撤销 | simple.md |
| 考勤：打卡记录/排班查询 | attendance.md |
| 日历：日程/参与者/会议室/闲忙查询 | calendar.md |
| 群聊与机器人：搜索群/建群/群成员管理/改群名/机器人群发/单聊/撤回/Webhook/机器人搜索 | chat.md |
| 通讯录：用户查询(当前用户/搜索/详情)/部门查询(搜索/子部门/成员列表) | contact.md |
| 开放平台文档：搜索开发文档 | simple.md |
| DING消息：发送/撤回（应用内/短信/电话） | ding.md |
| 日志：按模版创建/收件箱/已发送/模版查看/详情/已读统计 | report.md |
| 待办：创建(含优先级/截止时间)/查询/修改/标记完成/删除 | todo.md |
| 工作台：应用管理 | workbench.md |
| Product | Purpose | Reference Document |
|---|---|---|
| AI Table: CRUD operations for tables/data tables/fields/records/template search | aitable.md |
| Approval: Approval form/initiate instance/approval/revoke | simple.md |
| Attendance: Check-in record/schedule query | attendance.md |
| Calendar: Schedule/participant/meeting room/busy-free query | calendar.md |
| Group Chat & Bots: Search groups/create groups/manage group members/modify group names/bot mass messaging/one-on-one chat/recall/Webhook/bot search | chat.md |
| Address Book: User query(current user/search/details)/Department query(search/sub-departments/member list) | contact.md |
| Open Platform Documents: Search development documents | simple.md |
| DING Messages: Send/recall (in-app/SMS/phone call) | ding.md |
| Logs: Create via template/inbox/sent/view template/details/read statistics | report.md |
| Todo: Create(including priority/deadline)/query/modify/mark as complete/delete | todo.md |
| Workbench: Application management | workbench.md |
意图判断决策树
Intent Judgment Decision Tree
用户提到"表格/多维表/AI表格/记录/数据" →
用户提到"审批/请假/报销/出差/加班" →
用户提到"考勤/打卡/排班" →
用户提到"日程/日历/会议室/约会" →
用户提到"群聊/建群/群成员/群管理/机器人发消息/Webhook/机器人群发/机器人单聊/通知" →
用户提到"通讯录/同事/部门/组织架构" →
用户提到"开发/API/调用错误 文档" →
用户提到"DING/紧急消息/电话提醒" →
用户提到"日志/日报/周报/日志统计/写日报/提交周报/发日志/填日志" →
用户提到"待办/TODO/任务提醒" →
用户提到"工作台/应用管理" →
aitableapprovalattendancecalendarchatcontactdevdocdingreporttodoworkbench关键区分: aitable(数据表格) vs todo(待办任务)
关键区分: report(钉钉日志/日报周报) vs todo(待办任务)
关键区分: chat send-by-bot(机器人身份发消息) vs send-by-webhook(自定义机器人Webhook告警)
更多易混淆场景见 intent-guide.md
If the user mentions "table/multi-dimensional table/AI table/record/data" →
If the user mentions "approval/leave/reimbursement/business trip/overtime" →
If the user mentions "attendance/check-in/schedule" →
If the user mentions "schedule/calendar/meeting room/appointment" →
If the user mentions "group chat/create group/group member/group management/bot send message/Webhook/bot mass messaging/bot one-on-one chat/notification" →
If the user mentions "address book/colleague/department/organizational structure" →
If the user mentions "development/API/call error document" →
If the user mentions "DING/emergency message/phone reminder" →
If the user mentions "log/daily report/weekly report/log statistics/write daily report/submit weekly report/send log/fill log" →
If the user mentions "todo/TODO/task reminder" →
If the user mentions "workbench/application management" →
aitableapprovalattendancecalendarchatcontactdevdocdingreporttodoworkbenchKey Distinctions: aitable(data table) vs todo(todo task)
Key Distinctions: report(DingTalk log/daily/weekly report) vs todo(todo task)
Key Distinctions: chat send-by-bot(send message as bot) vs send-by-webhook(custom bot Webhook alert)
For more confusing scenarios, see intent-guide.md
危险操作确认
Dangerous Operation Confirmation
以下操作为不可逆或高影响操作，执行前必须先向用户展示操作摘要并获得明确同意，同意后才加 执行。
--yes| 产品 | 命令 | 说明 |
|---|---|---|
| | 删除整个 AI 表格，含全部数据表和记录 |
| | 删除记录（支持批量） |
| | 删除日程，所有参与者同步取消 |
| | 移除日程参与者 |
| | 取消会议室预定 |
| | 移除群成员 |
| | 删除待办 |
The following operations are irreversible or high-impact. You must first show the operation summary to the user and obtain explicit consent before execution. Add to execute only after consent.
--yes| Product | Command | Description |
|---|---|---|
| | Delete the entire AI Table, including all data tables and records |
| | Delete records (supports batch operation) |
| | Delete schedule, and all participants will be canceled synchronously |
| | Remove schedule participants |
| | Cancel meeting room reservation |
| | Remove group members |
| | Delete todo |
确认流程
Confirmation Process
Step 1 → 展示操作摘要（操作类型 + 目标对象 + 影响范围）
Step 2 → 用户明确回复确认（如 "确认" / "好的"）
Step 3 → 加 --yes 执行命令Step 1 → Display operation summary (operation type + target object + scope of impact)
Step 2 → User explicitly confirms (e.g., "Confirm" / "Yes")
Step 3 → Add --yes to execute the command核心流程
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 the four-step process below:
dws- Intent Classification: First, determine which category the core verb/action of 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, never guess. You must actively ask the user to clarify the intent. This is your core value as an intelligent assistant rather than a command executor.
- Precise 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 product.
- Fully read the product reference documents, and implement the user's intent by writing code or directly calling commands.
错误处理
Error Handling
- 遇到错误，加 重试一次
--verbose - 若 stderr 出现 ，优先按 recovery-guide.md 执行 recovery 闭环
RECOVERY_EVENT_ID=<event_id> - 仍然失败，报告完整错误信息给用户，禁止自行尝试替代方案
- 认证失败时，参考 global-reference.md 中的认证章节处理
- 各产品高频错误及排查流程见 error-codes.md
- When encountering an error, retry once with
--verbose - If appears in stderr, prioritize executing the recovery closed-loop according to recovery-guide.md
RECOVERY_EVENT_ID=<event_id> - If it still fails, report the complete error information to the user; never attempt alternative solutions on your own
- For authentication failures, refer to the authentication section in global-reference.md for handling
- High-frequency errors and troubleshooting processes for each product can be found in error-codes.md
详细参考 (按需读取)
Detailed References (Read On Demand)
- references/products/ — 各产品命令详细参考
- references/intent-guide.md — 意图路由指南（易混淆场景对照）
- references/global-reference.md — 全局标志、认证、输出格式
- references/field-rules.md — AI表格字段类型规则
- references/error-codes.md — 错误码 + 调试流程
- references/recovery-guide.md — recovery 闭环、、
RECOVERY_EVENT_ID规范execute/finalize - scripts/ — 各产品批量操作脚本（AI表格/日历/机器人消息/通讯录/考勤/日志/待办等）
- references/products/ — Detailed references for each product's commands
- 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
- references/recovery-guide.md — Recovery closed-loop, ,
RECOVERY_EVENT_IDspecificationsexecute/finalize - scripts/ — Batch operation scripts for each product (AI Table/Calendar/Bot Messages/Address Book/Attendance/Logs/Todo, etc.)