前言¶
團隊知識庫落在釘釘文檔上時，常見做法是手工上傳 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）。
