前言¶
日常辦公里，合同、報告、掃描件常以 PDF 形式流轉，而後續修訂往往要在 Word（DOC/DOCX）裏完成。手工另存、在線轉換或自寫腳本，要麼步驟多，要麼版式與可編輯性難以兼顧。把「PDF 轉 Word」做成 Agent Skill，可以在對話裏用自然語言觸發轉換，由技能封裝 Aspose.PDF 與純 Python 兩套實現，並按場景選擇不同轉換模式。
這是什麼¶
pdf-to-word（PDF 轉 Word 轉換工具） 是 SkillHub 上的社區技能，座標爲 @user_48bf225f/pdf-to-word-by-wp，當前版本 1.0.0，分類爲 office-efficiency，發佈者爲 user_48bf225f。標籤 requires_api_key=false，表示按官方說明無需單獨配置 API Key。
技能定位：將 PDF 轉爲 Word（DOC/DOCX），支持 Aspose.PDF 與 純 Python 雙方案，並提供 Flow（易編輯）、EnhancedFlow（增強流）、Textbox（高保真） 等模式，便於在「好改」與「版式接近原文」之間取捨。
SkillHub 頁面：https://www.skillhub.cn/skills/user_48bf225f/pdf-to-word-by-wp
技能 API 入口：https://api.skillhub.cn/user_48bf225f/pdf-to-word-by-wp
（頁面統計：評分 100000，下載 9111，安裝 88。）
核心功能¶
以下能力均來自 SkillHub 官方簡介，未在資料中出現的細節不展開。
- 格式：PDF → DOC / DOCX。
- 實現路徑：Aspose.PDF 方案與純 Python 方案，可按環境與許可選擇。
- 轉換模式：
- Flow：偏易編輯；
- EnhancedFlow：增強流；
- Textbox：高保真。 - 觸發語義（Agent 識別用）：PDF 轉 Word / DOC / DOCX；PDF 轉可編輯文檔；批量 PDF 轉換；aspose 相關操作。
安裝與啓用¶
安裝方式以 SkillHub 技能頁與 SkillHub 安裝文檔 爲準。
1、安裝 SkillHub CLI（若尚未安裝）¶
先檢查是否已有 CLI：
command -v skillhub && skillhub --version
未安裝時，可按文檔執行完整安裝（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
2、安裝本技能¶
安裝時必須用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/，可能不會被識別。
skillhub install @user_48bf225f/pdf-to-word-by-wp --dir <skills 目錄>
常用客戶端的 skills 目錄（摘自官方安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝後按你所用客戶端的慣例重啓或刷新 Agent，使技能被加載。
典型用法¶
公開資料未給出獨立 CLI 子命令示例；使用方式以 對話觸發 爲主。在已啓用該 Skill 的 Agent 中，可用與官方觸發詞一致的表述，例如：
- 說明要把某個 PDF 轉爲 Word（DOC 或 DOCX），並給出文件路徑或讓 Agent 在工作區內定位文件。
- 需要批量處理時，明確「批量 PDF 轉換」及文件列表或目錄。
- 若更在意可編輯性，可要求使用 Flow 或 EnhancedFlow；若更在意版式保留，可說明傾向 Textbox（高保真）。
- 環境允許且需要 Aspose 能力時，可在需求裏提到 aspose 相關操作，由技能在雙方案中選擇合適實現。
具體腳本參數、依賴安裝步驟以技能包內 SKILL.md 爲準；本文未收錄的內容請在安裝後閱讀該文件。
適用場景與注意¶
適合誰：需要在 Cursor、Claude Code、Codex 等支持 Skills 的環境裏，用自然語言完成 PDF→Word、偶爾批量轉換，並希望在「易編輯」與「高保真」之間顯式選模式的辦公與開發場景。
注意：
- 技能來源爲 community，行爲與依賴以安裝後的技能文檔爲準。
- Aspose.PDF 與純 Python 在許可、環境與輸出質量上可能不同，選用前確認本機依賴與合規要求。
- 掃描版 PDF、複雜版式或嵌入字體的文件，任何轉換方案都可能出現段落錯亂或樣式偏差；高保真模式有助於版式，但不保證與原件完全一致。
- 官方標明 requires_api_key=false；若後續版本變更配置項，以 SkillHub 頁面與 SKILL.md 爲準。
結尾¶
pdf-to-word 把 PDF 轉 DOC/DOCX、雙實現路徑與三種轉換模式收進一個 Skill，適合在 Agent 對話裏完成單文件或批量轉換。安裝與座標以 SkillHub 爲準：
- 技能頁：https://www.skillhub.cn/skills/user_48bf225f/pdf-to-word-by-wp
- 安裝說明：https://skillhub.cn/install/skillhub.md
