7.3 KiB
7.3 KiB
name, description, cli_version
| name | description | cli_version |
|---|---|---|
| dws | 管理钉钉产品能力(AI表格/日历/通讯录/群聊与机器人/待办/审批/考勤/日志/DING消息/工作台/开放平台文档等)。当用户需要操作表格数据、管理日程会议、查询通讯录、管理群聊、机器人发消息、创建待办、提交审批、查看考勤、提交日报周报（钉钉日志模版）时使用。 | >=1.1.0 |
钉钉全产品 Skill
通过 dws 命令管理钉钉产品能力。
严格禁止 (NEVER DO)
- 不要使用 dws 命令以外的方式操作（禁止 curl、HTTP API、浏览器）
- 不要编造 UUID、ID 等标识符，必须从命令返回中提取
- 不要猜测字段名/参数值，操作前必须先查询确认
严格要求 (MUST DO)
- 所有命令必须加
--format json以获取可解析输出 - 危险操作必须先向用户确认，用户同意后才加
--yes执行 - 单次批量操作不超过 30 条记录
- 所有命令必须严格遵循对应产品参考文档里面规定的参数格式（如：如果有参数值，则参数和参数值之间至少用一个空格隔开）
产品总览
| 产品 | 用途 | 参考文件 |
|---|---|---|
aitable |
AI表格：表格/数据表/字段/记录增删改查/模板搜索 | aitable.md |
approval |
审批：审批表单/发起实例/审批/撤销 | simple.md |
attendance |
考勤：打卡记录/排班查询 | attendance.md |
calendar |
日历：日程/参与者/会议室/闲忙查询 | calendar.md |
chat |
群聊与机器人：搜索群/建群/群成员管理/改群名/机器人群发/单聊/撤回/Webhook/机器人搜索 | chat.md |
contact |
通讯录：用户查询(当前用户/搜索/详情)/部门查询(搜索/子部门/成员列表) | contact.md |
devdoc |
开放平台文档：搜索开发文档 | simple.md |
ding |
DING消息：发送/撤回（应用内/短信/电话） | ding.md |
report |
日志：按模版创建/收件箱/已发送/模版查看/详情/已读统计 | report.md |
todo |
待办：创建(含优先级/截止时间)/查询/修改/标记完成/删除 | todo.md |
workbench |
工作台：应用管理 | workbench.md |
意图判断决策树
用户提到"表格/多维表/AI表格/记录/数据" → aitable
用户提到"审批/请假/报销/出差/加班" → approval
用户提到"考勤/打卡/排班" → attendance
用户提到"日程/日历/会议室/约会" → calendar
用户提到"群聊/建群/群成员/群管理/机器人发消息/Webhook/机器人群发/机器人单聊/通知" → chat
用户提到"通讯录/同事/部门/组织架构" → contact
用户提到"开发/API/调用错误 文档" → devdoc
用户提到"DING/紧急消息/电话提醒" → ding
用户提到"日志/日报/周报/日志统计/写日报/提交周报/发日志/填日志" → report
用户提到"待办/TODO/任务提醒" → todo
用户提到"工作台/应用管理" → workbench
关键区分: aitable(数据表格) vs todo(待办任务) 关键区分: report(钉钉日志/日报周报) vs todo(待办任务) 关键区分: chat send-by-bot(机器人身份发消息) vs send-by-webhook(自定义机器人Webhook告警)
更多易混淆场景见 intent-guide.md
危险操作确认
以下操作为不可逆或高影响操作，执行前必须先向用户展示操作摘要并获得明确同意，同意后才加 --yes 执行。
| 产品 | 命令 | 说明 |
|---|---|---|
aitable |
base delete |
删除整个 AI 表格，含全部数据表和记录 |
aitable |
record delete |
删除记录（支持批量） |
calendar |
event delete |
删除日程，所有参与者同步取消 |
calendar |
participant delete |
移除日程参与者 |
calendar |
room delete |
取消会议室预定 |
chat |
group members remove |
移除群成员 |
todo |
task delete |
删除待办 |
确认流程
Step 1 → 展示操作摘要（操作类型 + 目标对象 + 影响范围）
Step 2 → 用户明确回复确认（如 "确认" / "好的"）
Step 3 → 加 --yes 执行命令
核心流程
作为一个智能助手，你的首要任务是理解用户的真实、完整的意图，而不是简单地执行命令。在选择 dws 的产品命令前，必须严格遵循以下四步流程：
- 意图分类：首先，判断用户指令的核心 动词/动作 属于哪一类。这比关注名词更重要。
- 歧义处理与信息追问：如果用户指令模糊或包含多个产品的关键字，严禁猜测。必须主动向用户追问以澄清意图。这是你作为智能助手而非命令执行器的核心价值。
- 精准产品映射：在完成前两步，意图已经清晰后，参考产品总览和意图判断决策树 来选择产品。
- 充分阅读产品参考文件，通过编写代码或直接调用指令实现用户意图。
错误处理
- 遇到错误，加
--verbose重试一次 - 若 stderr 出现
RECOVERY_EVENT_ID=<event_id>，优先按 recovery-guide.md 执行 recovery 闭环 - 仍然失败，报告完整错误信息给用户，禁止自行尝试替代方案
- 认证失败时，参考 global-reference.md 中的认证章节处理
- 各产品高频错误及排查流程见 error-codes.md
详细参考 (按需读取)
- 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表格/日历/机器人消息/通讯录/考勤/日志/待办等）