dws

钉钉全产品 Skill

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

严格禁止 (NEVER DO)

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

严格要求 (MUST DO)

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

产品总览

产品	用途	参考文件
aitable	AI表格：表格/数据表/字段/记录增删改查/模板搜索	aitable.md
calendar	日历：日程/参与者/会议室/闲忙查询	calendar.md
contact	通讯录：用户查询(当前用户/搜索/详情)/部门查询(搜索/子部门/成员列表)	contact.md
doc	文档：搜索/浏览/读取/创建/更新文档/文件夹管理/块级编辑	doc.md
chat	群聊：群管理(建群/搜索/成员增删/改群名)/消息(拉取/发送/机器人群发/Webhook)/机器人搜索	chat.md
todo	待办：创建(含优先级/截止时间)/查询/修改/标记完成/删除	todo.md
mail	邮箱：查询邮箱/搜索/查看/发送邮件	mail.md
minutes	AI听记：列表/摘要/转写/关键字/标题修改	minutes.md
report	日志：收件箱/已发送/模版查看/详情/已读统计	report.md
drive	钉盘：浏览文件/元数据/下载/创建文件夹/上传文件	drive.md
ding	DING消息：发送/撤回（应用内/短信/电话）	ding.md
devdoc	开放平台文档：搜索开发文档	simple.md
conference	视频会议：预约会议	simple.md
aiapp	AI应用：创建/查询/修改AI应用	aiapp.md
live	直播：查看直播列表	simple.md
oa	OA审批：待处理/详情/同意/拒绝/撤销/记录/已发起/任务	oa.md
attendance	考勤：打卡记录/排班查询	attendance.md

意図判断の決定木

ユーザーが「表／多次元テーブル／AIテーブル／レコード／データ」に言及 → aitable ユーザーが「スケジュール／カレンダー／会議室／予定」に言及 → calendar ユーザーが「連絡先／同僚／部署／組織構造」に言及 → contact ユーザーが「ドキュメント／ナレッジベース／ドキュメント作成」に言及 → doc ユーザーが「ToDo／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（データテーブル）と doc（ドキュメント編集） 重要な区別：report（钉钉のログ／日報・週報）と doc（ドキュメント編集）と todo（タスク） 重要な区別：drive（钉盘のファイル保存／アップロード／ダウンロード）と doc（钉钉ドキュメントのコンテンツ読み書き／ナレッジベースのスペース） 重要な区別：conference（ビデオ会議の予約）と calendar event（日程管理） 重要な区別：chat message send（個人として一斉送信）と send-by-bot（ボットによるメッセージ送信）と send-by-webhook（Webhook アラート）

混同しやすい場面やユーザー表現の例については、intent-guide.md を参照してください。

コアフロー

アシスタントとして、最優先のタスクはコマンドを単純に実行することではなく、ユーザーの真の意図を全体として理解することです。dws の製品コマンドを選択する前に、以下の3段階のフローを必ず厳守してください。

1. 意図の分類：まず、ユーザーの指示の中心となる動詞／アクションがどのカテゴリに属するかを判断します。名詞に注目するよりも重要です。
2. 曖昧さへの対応と追加情報の確認：ユーザーの指示が曖昧な場合や、複数の製品のキーワードを含む場合、推測することは固く禁じられています。意図を明確にするため、必ずユーザーに確認してください。これは、単なるコマンド実行者ではなく、アシスタントとして提供すべき中核的な価値です。
3. 正確な製品へのマッピング：最初の2段階を完了し、意図が明確になったら、製品一覧と意図判断の決定木を参考に製品を選択します。
4. 製品のリファレンスファイルを十分に読み、コードを記述するかコマンドを直接呼び出して、ユーザーの意図を実現します。

エラー処理

1. エラーが発生した場合は、--verbose を追加して一度再試行します
2. それでも失敗する場合は、エラー情報をユーザーに報告します
3. 代替手段を独自に試すことは禁止されています
4. ID 認証に失敗した場合は、dws auth login を使用してログインできます

詳細なリファレンス（必要に応じて参照）

• references/products/ — 各製品のコマンドに関する詳細なリファレンス
• references/intent-guide.md — 意図のルーティングガイド（混同しやすい場面の比較）
• references/global-reference.md — グローバルフラグ、認証、出力形式
• references/field-rules.md — AIテーブルのフィールドタイプ規則
• references/error-codes.md — エラーコード＋デバッグ手順
• scripts/ — AIテーブルの一括操作スクリプト