前言¶
在自動化流程或對話式開發裏，經常要把本地的 Word、表格、圖片或網頁快照統一成 PDF 再歸檔、發審或入庫。本地裝 LibreOffice、寫腳本調各格式轉換器，維護成本高，格式一多還容易踩坑。若你已經在阿里雲市場使用「度慧文檔轉換」這類文檔轉 PDF 服務，更希望 Agent 在識別到相關意圖時直接走同一套異步 API，而不是每次手寫調用步驟。
下面介紹 SkillHub 上的社區 Skill「度慧文檔轉換-文檔轉PDF」（座標 @user_d9c601a2/duhui-all-to-pdf，版本 1.0.0），它把觸發條件與轉換能力寫進 SKILL.md，供 Cursor、Claude Code、Codex 等支持 Skills 的客戶端加載。
這是什麼¶
「度慧文檔轉換-文檔轉PDF」是 SkillHub 社區來源（community）的辦公效率類 Skill，發佈者爲 user_d9c601a2，分類爲 office-efficiency。
一句話定位：當需要藉助阿里雲市場的度慧文檔轉換，把單個本地文件通過異步 API 轉成 PDF 時，由 Agent 按 Skill 說明觸發並完成調用。
它解決的是「對話裏提到文檔轉 PDF，但 Agent 不知道該用哪家 API、支持哪些格式、何時該走異步任務」的問題；Skill 正文裏寫明瞭觸發詞與適用邊界，減少誤判和重複解釋。
核心功能¶
以下能力均來自 SkillHub 頁面與已抓取元數據，未展開的部分不在此編造。
-
單文件轉 PDF
面向單個本地文檔的轉換請求，不是批量目錄掃描（批量需自行在業務層循環，並注意服務配額）。 -
多類輸入格式
官方說明覆蓋 Office/WPS、OFD、圖片、文本、網頁等「任意文件」轉 PDF 的場景；具體以度慧文檔轉換服務當前支持的格式爲準。 -
異步 API 流程
轉換通過異步 API 完成，適合體積較大或耗時較長的文件；Agent 應按 Skill 內指引提交任務並輪詢或等待結果（具體步驟以安裝後的SKILL.md爲準）。 -
意圖觸發
當用戶提到「度慧」「文檔轉 PDF」「doc to pdf」「文檔轉換」「格式轉換」「文檔格式轉換」「PDF 轉換」，或明確需要異步 API 將本地文件轉爲 PDF 時，應觸發此 Skill。 -
需要 API Key
標籤requires_api_key=true表示使用前需配置度慧/阿里雲市場相關 API 憑證；未在公開頁面列出環境變量名時，以 Skill 包內文檔爲準。
SkillHub 側統計（抓取時）：評分 100000，下載 2210，安裝 181。
安裝與啓用¶
安裝前確認本機已有 skillhub CLI；若沒有，可先按 SkillHub 官方安裝說明安裝。
command -v skillhub && skillhub --version
未安裝時可執行（完整安裝，含默認 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 時，必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/ 可能不會被客戶端識別。官方頁面給出的包名爲 @user_d9c601a2/duhui-all-to-pdf。
以 Cursor 爲例，skills 目錄一般爲 ~/.cursor/skills/：
skillhub install @user_d9c601a2/duhui-all-to-pdf --dir ~/.cursor/skills/
其他常見客戶端路徑（來自 SkillHub 安裝文檔，按你實際使用的客戶端擇一）：
- Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝後按 Skill 包內說明配置 API Key，並重啓或重新加載 Agent 的 Skills 目錄，使 SKILL.md 生效。
典型用法¶
公開頁面未提供獨立腳本示例，典型用法是對話觸發 + Agent 按 Skill 調用度慧異步接口。可復現的交互方式如下。
- 在阿里雲市場開通並獲取「度慧文檔轉換」所需 API 憑證，按 Skill 內要求寫入配置（字段名以包內
SKILL.md爲準）。 - 將待轉換文件放在本機 Agent 可訪問的路徑。
- 在對話中明確意圖與文件，例如：「用度慧把
/path/to/report.docx轉成 PDF」或「文檔轉 PDF，文件在桌面上的 contract.ofd」。 - Agent 命中 Skill 後，應走異步 API：提交轉換任務，等待完成後將 PDF 路徑或下載結果返回給你。
觸發詞與官方簡介一致，便於檢索：度慧、文檔轉PDF、doc to pdf、文檔轉換、格式轉換、文檔格式轉換、PDF轉換。
適用場景與注意¶
適合誰
- 已在用或計劃用阿里雲市場度慧文檔轉換的團隊，希望 Coding Agent 統一走同一套轉 PDF 能力。
- 需要在對話裏偶爾把 Office/WPS、OFD、圖片、文本或網頁類本地文件打成 PDF，又不想每次查 API 文檔的開發者。
限制與注意
- 單文件：Skill 定位是單個本地文檔；多文件需多次調用或自建批處理，並關注 API 限流與費用。
- API Key：
requires_api_key=true，未配置憑證時 Agent 無法完成真實調用。 - 網絡與合規：調用的是雲端異步服務，文件會上傳到服務商；敏感文檔需先過企業安全與合規流程。
- 來源與版本：社區 Skill，版本 1.0.0；行爲以安裝包內
SKILL.md與度慧官方 API 文檔爲準，升級前留意變更說明。
結尾¶
「度慧文檔轉換-文檔轉PDF」把「何時用度慧、轉什麼、走異步 API」寫進 Agent Skill，適合把文檔轉 PDF 從一次性腳本變成可重複的對話能力。安裝與優先源配置可參考 SkillHub 安裝說明；Skill 詳情與安裝入口見 SkillHub 頁面 與 API 地址。
