菜单
钉钉文档（云文档）。Use when 用户说 写文档/读文档/创建文档/编辑文档/搜文档/文档块/分块编辑/Markdown 写入/上传文件到文档。Distinct from dingtalk-drive(钉盘文件存储)、dingtalk-aitable(数据表格)、dingtalk-wiki(知识库空间)。命令前缀：dws doc。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | dingtalk-doc |
| description | 钉钉文档（云文档）。Use when 用户说 写文档/读文档/创建文档/编辑文档/搜文档/文档块/分块编辑/Markdown 写入/上传文件到文档。Distinct from dingtalk-drive(钉盘文件存储)、dingtalk-aitable(数据表格)、dingtalk-wiki(知识库空间)。命令前缀：dws doc。 |
| cli_version | >=0.2.14 |
| metadata | {"category":"product","stability":"experimental","requires":{"bins":["dws"]}} |
🧪 EXPERIMENTAL · 试验版 / Preview — multi 模式当前未达 stable 标准。全部 dingtalk-* skill 已通过 dispatch verifier，但接口、命名、跨 skill 引用后续可能调整；生产 / 共享环境请优先使用 mono 模式（
dws skill setup --mode mono）。问题请提 issue 反馈。
PREREQUISITE: Read the
dws-sharedskill first for auth, global flags, product routing, URL preflight, error codes, and safety rules. Thedwsbinary must be on PATH.
⚠️ 命令可用性以当前 dws 二进制为准。服务发现已下线，本文档随内置 skill 发布；如果
dws <cmd> --help不存在，说明当前版本未暴露该命令。若命令存在但调用失败，请按错误中的 endpoint 或 tool 提示确认静态端点目录和后端工具注册。实际调用前可用dws <cmd> --help或--dry-run验证。
命令参考：doc.md；剧本：04-document.md；URL 识别与类型探测：url-patterns.md。
输入含 alidocs.dingtalk.com URL 时，该域名下存在多种路径格式：/i/p/...（分享短链）、/i/nodes/...（节点链接，类型需探测）、/spreadsheetv2/...（电子表格直链）、/document/edit|preview?dentryKey=...（文档链接）等，每种处理流程不同。必须先读 url-patterns.md 中的「alidocs URL 分流决策」，按规则识别 URL 类型后再选择对应命令；其中 /document/edit|preview?dentryKey=... 直接路由到 doc，将完整 URL 原样传给 --node，不要提取 dentryKey 当裸 nodeId。
--name，不要写 --title。--folder <文档文件夹nodeId或URL>，不要写 --parent / --parent-node / --parent-id。--workspace <workspaceId或URL>，不要写 --space-id / --spaceId。create / update 都只接 --content / --content-file，不要写 --markdown。.md，再用 --content-file，不要把大段 Markdown 塞进命令行。create / update / block insert / media insert 后必须 dws doc read 或 dws doc block list 回读关键内容。以下 shortcut 来自独立于 Runtime Schema 的公开 catalog。先按本 skill 的意图表、脚本和 recipe 路由：存在精确覆盖该场景的专用脚本/recipe 时按其执行；否则用户意图命中时，shortcut 优先于手写原子命令。用 dws shortcut list --service doc --format json 读取参数、约束、风险和示例，并以 dws doc <shortcut> --help 核对当前 Cobra flags；不要对 + 路径调用 dws schema。
| Shortcut | 风险 | 适用场景 |
|---|---|---|
dws doc +comment-create | write | 在文档上创建一条评论 |
dws doc +comment-list | read | 查询文档评论列表 |
dws doc +comment-reply | write | 回复文档中的一条评论 |
dws doc +copy | write | 复制文档/文件到指定文件夹或知识库 |
dws doc +doc-append | write | 在文档末尾追加一段文本（安全追加，不改动原有内容） |
dws doc +export-get | read | 根据 jobId 查询文档导出任务结果 |
dws doc +export-submit | read | 提交在线文档导出任务 (docx/markdown/pdf)，返回 jobId |
dws doc +find-doc | read | 按关键词搜索云文档并投影关键字段（只读） |
dws doc +list | read | 列出文件夹或知识库下的直接子节点 |
dws doc +move | write | 移动文档/文件到指定文件夹或知识库 |
dws doc +search | read | 按关键词搜索有权限的文档 (不传则返回最近访问) |
dws doc +share-doc | write | 按姓名把文档链接私信发给某人（自动解析 userId） |
dws doc +template-list | read | 获取文档模板列表 |
dws doc +template-search | read | 根据关键词搜索文档模板 |
dws doc +version-list | read | 查看文档历史版本列表 |
dws doc +version-revert | high-risk-write | 回滚文档到指定历史版本 |
dws doc +version-save | write | 手动保存文档版本快照 |
| 用户说 | 命令 |
|---|---|
| "创建文档（短内容）" | dws doc create --name "<标题>" --content "<内容>" |
| "创建+写入（长内容自动分块）" | python scripts/doc_create_and_write.py --name "<标题>" --content "<内容>" [--mode append|overwrite] |
| "搜文档"（全局） | dws drive search --query "<关键词>"（doc search 已弃用；切到 dingtalk-drive） |
| "在某知识库里搜文档" | dws wiki node search --workspace <WS_ID> --query "<关键词>" |
| "读文档内容" | dws doc read --node <nodeId> |
| "更新文档内容 / 分块追加" | dws doc update --node <nodeId> --content "<分块>" --mode append |
| "删除块" | dws doc block delete（需用户确认） |
| "更新文档评论" | dws doc comment update --node <nodeId> --comment-key <key> --content "<内容>" |
| "删除文档评论" | dws doc comment delete --node <nodeId> --comment-key <key> --yes（需用户确认） |
dws wiki space search --keyword "评测记录" --format json → dws wiki node list --workspace <WS_ID> --format json（或 dws drive list --workspace <WS_ID>；doc list 已弃用）→ 找 评测-doc-YYYYMMDD；不存在则 dws wiki node create --workspace <WS_ID> --name "评测-doc-YYYYMMDD" --type folder --format json（doc folder create 已弃用）。dws doc create --name "<标题>" --folder <FOLDER_NODE_ID> --content-file <tmp.md> --format json。拿到 nodeId 后立即回读。doc block list --node <nodeId> → 选 blockId → doc block insert/update/delete → doc block list 验证。删除块必须已有用户明确删除意图或二次确认。dws drive download --node ... --output <path>（doc download 已弃用，切到 dingtalk-drive）；用户说"导出在线文档为 docx"时用 doc export --node ... --output <path>（内容级命令，未迁移）。--format json；仅参数不确定时查 --help，不要把完整 help 当成最终结果。block delete 和 comment delete 不可逆，必须确认再加 --yes。
dingtalk-drivedingtalk-wikidingtalk-aitabledoc_create_and_write.py 脚本管理钉钉产品能力(AI表格/AI搜问/日历/通讯录/群聊与机器人/待办/审批/考勤/日志/DING消息/开放平台文档/钉钉文档/钉钉云盘/AI听记/邮箱/在线电子表格/知识库等)。当用户需要操作表格数据、管理日程会议、模糊找人/查谁负责某事项、查询通讯录、管理群聊、机器人发消息、创建待办、提交审批、查看考勤、提交日报周报（钉钉日志模版）、读写钉钉文档、上传下载云盘文件、查询听记纪要、收发邮件、读写在线电子表格(axls)、管理钉钉知识库时使用。
钉钉个人 IM 事件长连接监听、订阅与消费，覆盖消息接收、指定发送人、已读、撤回和表情回应，输出 NDJSON 到 stdout。Use when 用户提到 监听个人消息事件、被@消息、监听单聊或群消息、监听某人发送的消息、监听消息已读、监听消息撤回、监听消息贴表情或表情回应、实时接收钉钉事件、用事件驱动 Agent。命令前缀：dws event。
钉钉多组织 / profile 管理与跨组织取数。Use when 用户说 切换组织/换组织/跨组织/另一个钉钉/别的公司/多组织/看登录了哪些组织/profile，或在当前组织找不到群/人/数据需要去其他组织找。命令前缀：dws profile / dws auth / 全局 --profile。
dws 多 skill 模式的公共参考——认证、全局参数、Schema 命令发现、多组织 / --profile 规则、安全底线。所有 dingtalk-* 子 skill 执行前先读本 skill。命令前缀：dws。
钉钉通讯录查询与组织管理（用户、部门、角色、花名册、离职员工、创建企业、企业账号、邀请员工）。Use when 用户说 查部门/我的信息/按 userId 查/离职员工/创建企业/企业账号/邀请员工。Distinct from dingtalk-aisearch(模糊搜人首选：找同事/查上下级/谁负责)。命令前缀：dws contact。
钉钉开放平台企业内部应用管理：应用查询/创建/修改/删除/停启、凭证、权限点、成员、安全配置、网页应用、机器人、版本发布。Use when 用户说 开发者后台应用/开放平台应用/企业内部应用/agentId/clientId/appKey/appSecret/customKey/应用权限/权限点/scopeValue/创建机器人/智能体机器人/机器人配置/机器人回调/IP白名单/登录重定向/端内免登/应用版本/版本发布/发布审核/选审批人/把机器人接到本地调试/connect。