SuperAPI AI Directory

dws

General & other

View repository

Updated 10-16 01:25

About this skill

DingTalk Full Product Skill

Via dws commands to manage DingTalk product capabilities.

Strictly Prohibited (NEVER DO)

  • Do not use methods other than dws commands to operate (curl, HTTP API, and browsers are prohibited)
  • Do not fabricate identifiers such as UUIDs or IDs; they must be extracted from command returns
  • Do not guess field names/parameter values; query and confirm before operating

Strict Requirements (MUST DO)

  • All commands must include --format json to obtain parseable output
  • Before deletion operations, you must add --yes and confirm with the user
  • A single batch operation must not exceed 100 records
  • All commands muststrictly followthe parameter formats specified in the corresponding product reference documentation (for example: if there is a parameter value, there must be at least one space between the parameter and the parameter value)

Product Overview

Product Purpose Reference File
aitable AI Tables: create, read, update, and delete tables/data tables/fields/records; template search aitable.md
calendar Calendar: schedules/participants/meeting rooms/free-busy query calendar.md
contact Contacts: user query (current user/search/details)/department query (search/sub-departments/member list) contact.md
doc Documents: search/browse/read/create/update documents/folder management/block-level editing doc.md
chat Group Chat: group management (create group/search/add or remove members/change group name)/messages (retrieve/send/bot group send/Webhook)/bot search chat.md
todo To-dos: create (including priority/due time)/query/modify/mark complete/delete todo.md
mail Email: query mailbox/search/view/send email mail.md
minutes AI Minutes: list/summary/transcription/keywords/title modification minutes.md
report Logs: inbox/sent/template view/details/read statistics report.md
drive DingTalk Drive: browse files/metadata/download/create folder/upload file drive.md
ding DING messages: send/recall (in-app/SMS/phone) ding.md
devdoc Open Platform Documentation: search development documents simple.md
conference Video Conferencing: schedule meetings simple.md
aiapp AI Apps: create/query/modify AI apps aiapp.md
live Livestreaming: view livestream list simple.md
oa OA Approvals: pending/details/approve/reject/cancel/records/initiated/tasks oa.md
attendance Attendance: clock-in records/shift query attendance.md

Intent Judgment Decision Tree

User mentions "table/multi-dimensional table/AI table/record/data" → aitable User mentions "schedule/calendar/meeting room/date" → calendar User mentions "contacts/colleague/department/organizational structure" → contact User mentions "document/knowledge base/write document" → doc User mentions "to-do/TODO/task reminder" → todo User mentions "mail/email" → mail User mentions "AI Minutes/meeting recording/transcription/AI summary, as well as a user-provided AI Minutes URL (such as https://shanji.dingtalk.com/*)" → minutes User mentions "help me make/build/generate/generate system/AI app/create app/intelligent app" → aiapp User mentions "DING/urgent message/phone reminder" → ding User mentions "attendance/clock-in/shift scheduling" → attendance User mentions "group chat/group message/group member/chat history/create group/bot sends message/Webhook/notification" → chat User mentions "approval/OA" → oa User mentions "development/API/call error documentation" → devdoc User mentions "campus recruitment/post job/my candidates" → ai_sincere_hire User mentions "video conference/schedule meeting" → conference User mentions "live streaming" → live User mentions "log/daily report/weekly report/log statistics" → report User mentions "DingTalk Drive/file/cloud drive/download file/upload file" → drive User mentions "enterprise credit/business information/shareholder/court judgment/risk/trademark/patent/bidding/contact information/KP" → credit User mentions "legal consultation/laws and regulations/case/legal provision/precedent/legal basis" → law

Key distinction: aitable (data table) vs doc (document editing) Key distinction: report (DingTalk log/daily and weekly reports) vs doc (document editing) vs todo (to-do task) Key distinction: drive (DingTalk Drive file storage/upload/download) vs doc (DingTalk document content reading and writing/knowledge base space) Key distinction: conference (video conference scheduling) vs calendar event (calendar schedule management) Key distinction: chat message send (mass send as individual) vs send-by-bot (bot sends message) vs send-by-webhook (Webhook alert)

For more confusing scenarios and user expression examples, see intent-guide.md

Core process

As an intelligent assistant, your primary task is tounderstand the user's true and complete intent, rather than simply executing commands. Before choosing the dws product command, you must strictly follow the following three-step process:

  1. 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.
  2. Ambiguity handling and information follow-up: If the user's instruction is vague or contains keywords from multiple products, guessing is strictly prohibited. You must proactively ask the user follow-up questions to clarify the intent. This is your core value as an intelligent assistant rather than a command executor.
  3. Precise product mapping: After completing the first two steps and the intent is clear, refer to the product overview and intent determination decision tree to choose the product.
  4. Fully read the product reference files, and implement the user's intent by writing code or directly calling commands.

Error handling

  1. If an error occurs, add --verbose and retry once
  2. If it still fails, report the error information to the user
  3. Do not attempt alternative solutions on your own
  4. If identity verification fails, you can use dws auth login to log in

Detailed reference (read as needed)