前言¶
团队知识库落在钉钉文档上时，常见做法是手工上传 Markdown、在网页里改段落、或自己写开放平台脚本调 API。本地草稿、CI 产出和 Agent 对话里的内容，要同步到知识库往往还要再切一层工具。下面介绍 SkillHub 上的「钉钉文档skill」：把钉钉文档相关操作收敛成 Agent 可调用的 Skill，在对话里完成推送、拉取、编辑和库内管理。
这是什么¶
「钉钉文档skill」是社区来源（community）的 Agent Skill，坐标为 @user_924c5114/dingtalk-docs-skill，当前版本 1.0.4，分类为 office-efficiency。发布者为 SkillHub 用户 user_924c5114（页面标注作者 Sean Liu）。
Skill 面向「要通过 Agent 操作钉钉文档 / 钉钉知识库」的场景：读写云端文档、维护目录结构、导出与权限等。若只需改本地文件、或要操作飞书、语雀、Notion 等平台，以及管理钉钉 IM 消息或群组，官方说明明确要求不要使用本 Skill。
Skill 带有 requires_api_key=true 标签，使用前需按 Skill 内指引完成钉钉侧凭证与 MCP 相关配置（含「初始化钉钉文档 MCP 配置」能力）。
核心功能¶
以下能力与 SkillHub 页面及已抓取元数据一致，按工作流归纳。
内容与同步¶
- 将本地 Markdown 推送到钉钉知识库。
- 从云端拉取文档到本地。
- 覆盖或追加更新文档内容。
- 块级精确编辑（针对文档块结构做定向修改，而非只能整篇替换）。
检索与文件¶
- 搜索、列出知识库中的文档。
- 下载文件与附件。
- 导出文档为 PDF 或 Word。
库内管理与权限¶
- 创建、重命名、移动、复制、删除文档与文件夹。
- 管理节点权限。
- 初始化钉钉文档 MCP 配置，便于在支持 MCP 的 Agent 环境中接入钉钉文档能力。
安装与启用¶
安装 SkillHub CLI¶
先确认本机是否已有 skillhub：
command -v skillhub && skillhub --version
若未安装，可按 SkillHub 官方安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本 Skill¶
官方页面给出的安装方式是：让 Agent 参照 SkillHub 安装说明，安装坐标 @user_924c5114/dingtalk-docs-skill。
在终端中，需把技能装到当前 Agent 实际识别的 skills 目录（安装文档强调必须使用 --dir，否则默认落在 ./skills/ 可能不会被加载）：
skillhub install @user_924c5114/dingtalk-docs-skill --dir <你的 Agent skills 目录>
常见路径示例（以官方安装文档为准，按你使用的客户端择一）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装或更新 Skill 后，按你所用客户端的要求重启或刷新 Agent，使 SKILL.md 被加载。
API Key 与 MCP¶
标签 requires_api_key=true 表示需要配置钉钉开放平台或文档 API 相关密钥。具体字段名、初始化步骤以 Skill 包内 SKILL.md 及「初始化钉钉文档 MCP 配置」相关说明为准；不要在未阅读 Skill 正文前臆造环境变量名。
典型用法¶
官方页面未附带独立脚本示例，用法以自然语言任务 + Agent 按 Skill 指引调用工具为主。可按下面几类需求在对话中描述意图（表述需包含目标文档、知识库位置或文件名等上下文）：
- 发布草稿：提供本地 Markdown 路径，要求推送到指定知识库目录。
- 双向同步：拉取某篇云端文档到本地路径，或在本地改完后覆盖/追加回云端。
- 局部修订：说明要改的块或段落，使用块级编辑而非整篇重传。
- 运维知识库：列出或搜索文档、新建文件夹、移动/重命名/复制/删除节点、调整节点权限。
- 交付物导出：将指定文档导出为 PDF 或 Word，或下载附件到本地。
首次使用前，可先让 Agent 执行 Skill 中的 MCP 初始化流程，再发起上述操作。
适用场景与注意¶
适合谁
- 已在用 Cursor、Claude Code、Codex 等支持 Skills 的 Agent，且知识库在钉钉文档上的团队或个人。
- 希望用对话完成「本地 Markdown ↔ 知识库」「批量整理目录」「导出 PDF/Word」等重复性办公操作，而不是每次打开钉钉网页手工点选。
边界与限制
- 仅覆盖钉钉文档 / 知识库，不替代飞书、语雀、Notion 等平台的 Skill。
- 不处理钉钉 IM、群组消息；也不代替本地纯文件编辑（无云端目标时不必启用本 Skill）。
- 依赖钉钉 API 与网络环境；密钥需自行在钉钉开放平台申请并妥善保管。
- SkillHub 元数据：分类 office-efficiency，社区来源；页面展示评分与下载量会随商店统计变化，以 SkillHub 技能页 为准。
结尾¶
「钉钉文档skill」把知识库推送、拉取、块级编辑、检索、导出和目录权限等能力写进标准 Skill 流程，适合把钉钉文档纳入 Agent 日常办公链路。安装坐标 @user_924c5114/dingtalk-docs-skill，说明与安装入口见官方地址：https://api.skillhub.cn/user_924c5114/dingtalk-docs-skill（SkillHub 展示页：https://www.skillhub.cn/skills/user_924c5114/dingtalk-docs-skill）。
