Dingtalk Drive
FreeManage files in Dingtalk with simple commands.
Free · Opens the source repo
What Dingtalk Drive does
Dingtalk Drive is a file management skill designed for users of the Dingtalk platform. It allows users to perform various file operations such as uploading, downloading, copying, moving, renaming, and deleting files within the Dingtalk ecosystem. The skill is particularly useful for teams and individuals who frequently manage documents and need a streamlined way to access and organize their files. With a command prefix of dws drive, users can execute commands that cater to their specific file management needs.
This skill operates on a set of predefined commands that correspond to common user intents, such as searching for files, listing directories, and managing file permissions. The commands are structured to ensure that users can easily interact with their files without extensive manual navigation. For instance, users can quickly find files using keywords or retrieve metadata about specific documents, which enhances productivity and reduces the time spent on file management tasks.
Dingtalk Drive also emphasizes safety and proper workflow. Before executing any operations, users are required to follow a standard operating procedure (SOP) that ensures all actions are confirmed and validated. This approach minimizes the risk of accidental data loss or mismanagement. The skill's design is particularly suited for organizations that rely on Dingtalk for collaboration, as it integrates seamlessly with other Dingtalk features, such as document editing and knowledge management.
Overall, Dingtalk Drive is an essential tool for anyone looking to efficiently manage files within the Dingtalk environment, providing a robust set of commands and a focus on user safety and workflow integrity.
When to use it
Use this skill when you need to manage files in Dingtalk, such as uploading, downloading, or organizing documents.
When not to use it
This skill may not be suitable for users who do not use Dingtalk or require advanced file management features not covered by the basic commands.
What you can build with it
Uploading Files
Easily upload local files to your Dingtalk Drive using the command `dws drive upload --file <path>`.
Searching for Documents
Quickly find files by using the `dws drive search --query <keyword>` command to search through your Dingtalk files.
Managing File Permissions
Use the skill to manage permissions for your files, ensuring the right access for team members.
How to install Dingtalk Drive
View source1. Install with the skills CLI
npx skills add dingtalk-real-ai/dingtalk-workspace-cli/dingtalk-drive --agent claude-code2. Or install it manually
Download the skill folder and drop it into ~/.claude/skills/ for all projects, or .claude/skills/ to scope it to one repo. Restart Claude Code so it picks up the new skill.
Anthropic's agentic coding CLI, and the reference implementation of Agent Skills. Drop a skill folder into ~/.claude/skills and Claude Code loads it automatically whenever a task matches the skill's description. Claude Code docs
Inside SKILL.md
Written by dingtalk-real-ai钉盘 Skill
前置条件 — 执行操作前必读
**CRITICAL — 执行任何
dws操作前，MUST 先用 Read 工具完整读取dingtalk-shared。**该轻量文件包含全局执行契约、安全底线及 shared references 的按需加载导航；不要预加载其全部 references。
<!-- VISIBLE_SHORTCUTS_START -->命令参考：drive.md。
Shortcuts（无专用脚本/recipe 时优先）
以下 shortcut 同时进入公开 catalog 与 Runtime Schema。先按本 skill 的意图表、脚本和 recipe 路由：存在精确覆盖该场景的专用脚本/recipe 时按其执行；否则用户意图命中时，shortcut 优先于手写原子命令。命令已选中时直接执行；只在参数或安全语义不确定时读取 Agent leaf Schema（例如 dws schema --cli-path "drive +<shortcut>" --compact --format json），在当前 Cobra flags 不确定时读取 dws drive <shortcut> --help。只有参数映射、接口绑定或 provenance 审计才省略 --compact。仅当现有路由和 reference 都无法定位低频能力时，才用 dws shortcut list --service drive --format json 批量发现。
| Shortcut | 风险 | 适用场景 |
|---|---|---|
dws drive +copy | write | 复制文件/文档到指定位置 |
dws drive +find-file | read | 按名称关键词搜索钉盘文件并投影关键字段（只读） |
dws drive +info | read | 获取钉盘文件/文件夹元数据 |
dws drive +move | write | 移动文件/文档到指定位置 |
dws drive +recent | read | 获取最近访问/编辑的文档列表 |
dws drive +search | read | 搜索钉盘文件 |
dws drive +search-docs | read | 搜索文档空间文档 |
意图表
| 用户说 | 命令 |
|---|---|
| "看钉盘文件 / 文件夹列表" | dws drive list [--folder <dentryUuid>] |
| "钉盘目录树" | python scripts/drive_tree_list.py --depth 2 |
| "查文件元数据" | dws drive info --node <dentryUuid> |
| "搜文件 / 找文件" | dws drive search --query "<关键词>" |
| "下载文件" | dws drive download --node <dentryUuid> --output <path> |
| "上传文件" | dws drive upload --file <path> [--folder <id>] |
| "建钉盘文件夹" | dws drive mkdir --name "<名称>" [--folder <id>] |
| "复制/移动/重命名/删除/权限管理" | dws drive copy/move/rename/delete/permission ... |
| "回收站 / 还原删除的文件" | dws drive recycle list / dws drive recycle restore --id <recycleItemId> |
标准 SOP（必遵流程）
命中以下意图必须按对应 SOP 顺序执行；禁止跳步、替换命令、编造 dentryUuid/nodeId。每条命令必须带
--format json。破坏性操作（删除/移动/覆盖/公开）必须先与用户确认。
SOP-1 找文件（find-file）
触发：找文件/搜文件/我的文件/最近文件/某文档在哪。
- 选源（必须）：最近访问 →
dws drive recent --limit <n> --format json（翻页用上次返回的nextCursor传--cursor）；按内容/名称全局搜 →dws drive search --query "<关键词>" --format json；浏览某目录 →dws drive list --folder <dentryUuid> --format json。 - 解析（必须）：取真实
dentryUuid（=id/nodeId）；多候选让用户确认，禁止默认取第一个。 - 下钻（必须）：根目录没命中时，进入最相关文件夹继续
drive list --folder，必要时python scripts/drive_tree_list.py --depth 2递归，禁止只看根目录就放弃。 - 回读元数据（必须）：命中后
dws drive info --node <dentryUuid> --format json，按extension确认类型。
禁止：编造 dentryUuid、只看根目录放弃、用 drive list 替代 drive search 做全局查找。
SOP-2 上传 / 下载（upload-download）
触发：上传文件/下载文件/传到钉盘/用本地文件覆盖已有文件。
- 上传（必须）：
dws drive upload --file <本地路径> [--folder <dentryUuid>] --format json；返回取dentryUuid，用drive info --node回读确认。 - 覆盖（必须）：先
dws drive info --node <dentryUuid> --format json，记录真实extension和原name。extension=md切dingtalk-misc的references/markdown.md，先markdown overwrite --dry-run再确认执行；其他普通文件在用户确认后执行dws drive upload --node <dentryUuid> --file <本地路径> --file-name "<原name>" --format json，随后再次drive info回读。adoc/axls/able切对应内容 skill/reference，不按普通文件覆盖。 - 下载（必须）：先
dws drive info --node <dentryUuid> --format json判断类型——extension=adoc切dingtalk-doc用doc export；普通文件执行dws drive download --node <dentryUuid> --output <本地路径> --format json。
禁止：对在线文档用 drive download（会失败）、普通文件覆盖时省略 --file-name 导致隐式重命名、上传或覆盖后不回读。
SOP-3 文件夹 / 复制 / 移动 / 重命名（folder-ops）
触发：建文件夹/复制/移动/重命名。
- 执行（必须）：建钉盘文件夹
dws drive mkdir --name "<名称>" [--folder <id>]；复制drive copy --node <dentryUuid> --folder <目标>；移动drive move --node <dentryUuid> --folder <目标>；重命名drive rename --node <dentryUuid> --name "<新名>"。全部加--format json。 - 验证（必须）：操作后
drive info --node <新dentryUuid>或drive list --folder <目标>回读。
禁止：未确认就移动/覆盖他人文件、跳过回读。
SOP-4 回收站（recycle）
触发：删文件/回收站/还原。
- 删除（必须）：
dws drive delete --node <dentryUuid> --format json（必须先与用户确认）。 - 还原（必须）：
dws drive recycle list --format json取recycleItemId→dws drive recycle restore --id <recycleItemId> --format json。
禁止：未确认就删除、把 dentryUuid 当 recycleItemId 传给 restore。
SOP-5 互联网公开（publish）
触发：互联网公开/取消公开/查公开状态。
- 执行（必须）：查状态
dws drive publish get --node <dentryUuid> --format json；开启公开dws drive publish set --node <dentryUuid> --yes（[危险] 必须用户确认）；关闭公开dws drive publish unset --node <dentryUuid> --yes。 - 边界（必须）：对外公开前必须与用户确认边界与后果。
禁止：未确认就 publish set、跳过 --yes。
高频硬约束
- 查找文件不要只看根目录后放弃；根目录没命中时，进入最相关的目标文件夹继续
drive list --folder <dentryUuid>，必要时用目录树脚本递归到合理深度。 drive list默认--limit 20，自动化场景里保守使用--limit 50以内并处理nextToken翻页；不要因为参数边界报错反复重试。- 全局找文件优先
drive search --query；指定目录浏览用drive list，命中后必须drive info --node <dentryUuid> --format json回读元数据。 - 删除、覆盖、移动等破坏性操作必须确认；上传、创建文件夹、下载后要读回或列目录验证。
- 所有
dws drive命令加--format json。
跨产品协作
- 文件内容编辑（钉钉文档）→ 切到
dingtalk-doc - 知识库空间 → 切到
dingtalk-wiki
局部意图与短流程
Frequently asked questions about Dingtalk Drive
Similar skills
Slidev
Create interactive web-based presentations with Markdown.
Axiom
Audit your assumptions for clearer decision-making.
2slides Presentation Generation
Generate professional presentations with AI.
Performance Review Writer
Draft personalized performance reviews effortlessly.
Legal Team Briefing
Generate contextual briefings for legal workflows.
Search
Efficiently find documents and discussions across connected sources.