技能介绍

要解决的具体问题

在 Agent 中操作钉钉文档时，问题通常不是单一接口调用，而是把用户意图稳定映射到正确对象：正文是 adoc、表格是 axls、快捷方式是 dlink，文件需要原样上传还是转成在线文档，默认知识库是否已配置，节点 ID 是否可解析。缺少这些约束时，容易误读非文字节点、覆盖错误文档，或在长文本推送时触发字符上限。

技能如何工作

该技能依赖名为 dingtalk-doc 的钉钉文档 MCP Server。初始化时会配置 MCP，并把默认知识库 URL 写入 references/dingtalk.config；后续操作优先读取该配置或环境变量。常用路径包括：

用 search_documents、list_nodes 或 get_document_info 定位目标
用 get_document_content 读取 adoc 正文
用 create_document、update_document 创建或更新在线文字文档
用 list_document_blocks 和块级工具做段落、标题、表格编辑
用 get_file_upload_info、HTTP PUT、commit_uploaded_file 上传 HTML、图片、PDF、Office 文件
用 submit_export_job 与 query_export_job 轮询导出结果

适用边界与注意点

create_document 和 update_document 只支持 adoc 文字文档，且 Markdown 参数有 10,000 字符 上限。超过 9,500 字符 时，需要让用户选择分段追加或上传原始 .md 文件，不能擅自转换。表格、演示、脑图、白板、快捷方式等非正文节点不能按 adoc 读取；mermaid 代码块不会自动变成钉钉原生绘图。写操作前需要确认目标位置、文件名和方案，删除节点通常进入回收站。