$npx -y skills add stvlynn/dingtalk-wukong-skills --skill dws管理钉钉产品能力(AI表格/日历/通讯录/文档/机器人/待办/邮箱/听记/AI应用/审批/日志/钉盘等)。当用户需要操作表格数据、管理日程会议、查询通讯录、发送消息通知、处理审批流程、查看听记摘要、创建应用/系统/管理后台/业务工具、查看日报周报、管理钉盘文件时使用。
| 1 | # 钉钉全产品 Skill |
| 2 | |
| 3 | 通过 `dws` 命令管理钉钉产品能力。 |
| 4 | |
| 5 | ## 严格禁止 (NEVER DO) |
| 6 | - 不要使用 dws 命令以外的方式操作(禁止 curl、HTTP API、浏览器) |
| 7 | - 不要编造 UUID、ID 等标识符,必须从命令返回中提取 |
| 8 | - 不要猜测字段名/参数值,操作前必须先查询确认 |
| 9 | |
| 10 | ## 严格要求 (MUST DO) |
| 11 | - 所有命令必须加 `--format json` 以获取可解析输出 |
| 12 | - 删除操作前必须加 `--yes` 并和用户确认 |
| 13 | - 单次批量操作不超过 100 条记录 |
| 14 | - 所有命令必须**严格遵循**对应产品参考文档里面规定的参数格式(如:如果有参数值,则参数和参数值之间至少用一个空格隔开) |
| 15 | |
| 16 | |
| 17 | ## 产品总览 |
| 18 | |
| 19 | | 产品 | 用途 | 参考文件 | |
| 20 | |-------------------|------------------------------------------------------|----------------------------------------------------------------| |
| 21 | | `aitable` | AI表格:表格/数据表/字段/记录增删改查/模板搜索 | [aitable.md](./references/products/aitable.md) | |
| 22 | | `calendar` | 日历:日程/参与者/会议室/闲忙查询 | [calendar.md](./references/products/calendar.md) | |
| 23 | | `contact` | 通讯录:用户查询(当前用户/搜索/详情)/部门查询(搜索/子部门/成员列表) | [contact.md](./references/products/contact.md) | |
| 24 | | `doc` | 文档:搜索/浏览/读取/创建/更新文档/文件夹管理/块级编辑 | [doc.md](./references/products/doc.md) | |
| 25 | | `chat` | 群聊:群管理(建群/搜索/成员增删/改群名)/消息(拉取/发送/机器人群发/Webhook)/机器人搜索 | [chat.md](./references/products/chat.md) | |
| 26 | | `todo` | 待办:创建(含优先级/截止时间)/查询/修改/标记完成/删除 | [todo.md](./references/products/todo.md) | |
| 27 | | `mail` | 邮箱:查询邮箱/搜索/查看/发送邮件 | [mail.md](./references/products/mail.md) | |
| 28 | | `minutes` | AI听记:列表/摘要/转写/关键字/标题修改 | [minutes.md](./references/products/minutes.md) | |
| 29 | | `report` | 日志:收件箱/已发送/模版查看/详情/已读统计 | [report.md](./references/products/report.md) | |
| 30 | | `drive` | 钉盘:浏览文件/元数据/下载/创建文件夹/上传文件 | [drive.md](./references/products/drive.md) | |
| 31 | | `ding` | DING消息:发送/撤回(应用内/短信/电话) | [ding.md](./references/products/ding.md) | |
| 32 | | `devdoc` | 开放平台文档:搜索开发文档 | [simple.md](./references/products/simple.md) | |
| 33 | | `conference` | 视频会议:预约会议 | [simple.md](./references/products/simple.md) | |
| 34 | | `aiapp` | AI应用:创建/查询/修改AI应用 | [aiapp.md](./references/products/aiapp.md) | |
| 35 | | `live` | 直播:查看直播列表 | [simple.md](./references/products/simple.md) | |
| 36 | | `oa` | OA审批:待处理/详情/同意/拒绝/撤销/记录/已发起/任务 | [oa.md](./references/products/oa.md) | |
| 37 | | `attendance` | 考勤:打卡记录/排班查询 | [attendance.md](./references/products/attendance.md) | |
| 38 | |
| 39 | ## 意图判断决策树 |
| 40 | |
| 41 | 用户提到"表格/多维表/AI表格/记录/数据" → `aitable` |
| 42 | 用户提到"日程/日历/会议室/约会" → `calendar` |
| 43 | 用户提到"通讯录/同事/部门/组织架构" → `contact` |
| 44 | 用户提到"文档/知识库/写文档" → `doc` |
| 45 | 用户提到"待办/TODO/任务提醒" → `todo` |
| 46 | 用户提到"邮件/邮箱" → `mail` |
| 47 | 用户提到"听记/会议录音/转写/AI摘要以及用户传入听记URL(如 `https://shanji.dingtalk.com/*`)" → `minutes` |
| 48 | 用户提到"帮我做/建/生成/生成系统/AI应用/创建应用/智能应用" → `aiapp` |
| 49 | 用户提到"DING/紧急消息/电话提醒" → `ding` |
| 50 | 用户提到"考勤/打卡/排班" → `attendance` |
| 51 | 用户提到"群聊/群消息/群成员/聊天记录/建群/机器人发消息/Webhook/通知" → `chat` |
| 52 | 用户提到"审批/OA" → `oa` |
| 53 | 用户提到"开发/API/调用错误 文档" → `devdoc` |
| 54 | 用户提到“校招/发布职位/我的候选人” → `ai_sincere_hire` |
| 55 | 用户提到"视频会议/预约会议" → `conference` |
| 56 | 用户提到"直播" → `live` |
| 57 | 用户提到"日志/日报/周报/日志统计" → `report` |
| 58 | 用户提到"钉盘/文件/网盘/下载文件/上传文件" → `drive` |
| 59 | 用户提到"企业信用/工商信息/股东/裁判文书/风险/商标/专利/招投标/联系方式/KP" → `credit` |
| 60 | 用户提到"法律咨询/法规/案例/法条/判例/法律依据" → `law` |
| 61 | |
| 62 | 关键区分: aitable(数据表格) vs doc(文档编辑) |
| 63 | 关键区分: report(钉钉日志/日报周报) vs doc(文档编辑) vs todo(待办任务) |
| 64 | 关键区分: drive(钉盘文件存储/上传/下载) vs doc(钉钉文档内容读写/知识库空间) |
| 65 | 关键区分: conference(视频会议预约) vs calendar event(日历日程管理) |
| 66 | 关键区分: chat message send(个人身份群发) vs send-by-bot(机器人发消息) vs send-by-webhook(Webhook告警) |
| 67 | |
| 68 | |
| 69 | > 更多易混淆场景及用户表达示例,见 [intent-guide.md](./references/intent-guide.md) |
| 70 | |
| 71 | ## 核心流程 |
| 72 | 作为一个智能助手,你的首要任务是**理解用户的真实、完整的意图**,而不是简单地执行命令。在选择 `dws` 的产品命令前,必须严格遵循以下三步流程: |
| 73 | |
| 74 | 1. 意图分类:首先,判断用户指令的核心 动词/动作 属于哪一类。这比关注名词更重要。 |
| 75 | 2. 歧义处理与信息追问:如果用户指令模糊或包含多个产品的关键字,严禁猜测。必须主动向用户追问以澄清意图。这是你作为智能助手而非命令执行器的核心价值。 |
| 76 | 3. 精准产品映射:在完成前两步,意图已经清晰后,参考产品总览和意图判断决策树 来选择产品。 |
| 77 | 4. 充分阅读产品参考文件,通过编写代码或直接调用指令实现用户意图。 |
| 78 | |
| 79 | ## 错误处理 |
| 80 | 1. 遇到错误,加 `--verbose` 重试一次 |
| 81 | 2. 仍然失败,报告错误信息给用户 |
| 82 | 3. 禁止自行尝试替代方案 |
| 83 | 4. 如果出现身份校验失败,可以使用 dws auth login 进行登录 |
| 84 | |
| 85 | ## 详细参考 (按需读取) |
| 86 | |
| 87 | - [references/products/](./references/products/) — 各产品命令详细参考 |
| 88 | - [references/intent-guide.md](./references/intent-guide.md) — 意图路由指南(易混淆场景对照) |
| 89 | - [references/global-reference.md](./references/global-reference.md) — 全局标志、认证、输出格式 |
| 90 | - [references/field-rules.md](./references/field-rules.md) — AI表格字段类型规则 |
| 91 | - [referenc |