前言¶
在自動化流水線或本地腳本里處理 PDF、Word、Excel、PPT，常見做法是各裝一套庫，再爲「轉 PDF」「抽表格」「改模板」分別寫膠水代碼。轉換環節往往還要綁本機 WPS 或 Microsoft Office，環境一換就容易踩坑。若你希望 Agent 按統一約定完成「文件進、文件出」的批處理，而不是每次從零拼命令，SkillHub 上的 Office Toolkit（座標 @user_5d13378c/office-toolkit-ela，當前版本 1.5.1）把讀取、創建、轉換、編輯四類能力收進一個 Skill，並標明讀取側爲零依賴純 Python、轉換側支持雙辦公套件引擎。下面介紹它是什麼、能做什麼，以及如何安裝啓用。
這是什麼¶
Office Toolkit 是社區來源（community）的 Agent Skill，分類爲 office-efficiency，由發佈者 user_5d13378c 維護。官方入口：
- Skill 包地址：https://api.skillhub.cn/user_5d13378c/office-toolkit-ela
- SkillHub 展示頁：https://www.skillhub.cn/skills/user_5d13378c/office-toolkit-ela
定位一句話：Office 文件離線批處理工具箱，專注「文件進、文件出」，覆蓋 PDF、DOCX、PPTX、XLSX 的讀取、創建、轉換與編輯，面向批量、離線、自動化場景。標籤 requires_api_key=false，不依賴外部 API Key。
核心功能¶
以下能力均來自 SkillHub 簡介與頁面說明，未單獨列出的細節以安裝後 Skill 內 SKILL.md 爲準。
讀取¶
- 支持從上述四類 Office 相關格式中提取內容。
- 讀取零依賴：純 Python、跨平臺，適合在無桌面 Office 的環境裏先跑通「讀文件」鏈路。
創建與編輯¶
- 可創建、編輯 DOCX、PPTX、XLSX、PDF 等（具體能力以 Skill 文檔爲準）。
- XLSX 側強調：支持公式；並提供 13 種財務配色約定——藍表示輸入、黑表示公式、綠表示跨表引用，便於生成符合財務閱讀習慣的工作表。
格式轉換¶
- 轉換支持 WPS 與 Microsoft Office 雙引擎（本機需安裝對應套件時由引擎完成渲染類轉換）。
- 輸出方向包括轉爲 PDF、CSV、JSON 等（簡介中明確列出 →PDF / →CSV / →JSON）。
安裝與啓用¶
安裝流程遵循 SkillHub 官方說明：https://skillhub.cn/install/skillhub.md
1、檢查或安裝 SkillHub CLI¶
確認本機是否已有 skillhub：
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、安裝 Office Toolkit¶
安裝時必須用 --dir 指向當前 Agent 正在使用的 skills 目錄，否則默認落在 ./skills/，Agent 可能無法加載。
skillhub install user_5d13378c/office-toolkit-ela --dir <你的 skills 目錄>
SkillHub 頁面亦支持將下面這句發給 AI，由其按安裝文檔完成安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_5d13378c/office-toolkit-ela`。
3、常見 Agent 的 skills 目錄¶
按 SkillHub 安裝文檔，常用路徑包括：
| 環境 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ 或 .windsurf/skills/ |
安裝到對應目錄後，按你所用客戶端的要求刷新或重啓 Agent，使 Skill 生效。
典型用法¶
公開頁面未附帶獨立命令行 demo；該 Skill 基於通用 SKILL.md 格式，由 Agent 在安裝後讀取技能說明並調用內置腳本或流程。可復現的使用方式如下。
- 完成上一節安裝，確認 Skill 出現在 Agent 的 skills 列表中。
- 在對話中用自然語言描述輸入文件路徑、期望操作與輸出路徑，並限定在 Skill 支持的範圍內，例如：
- 批量將某目錄下 DOCX 轉爲 PDF；
- 讀取 XLSX 並導出 CSV 或 JSON；
- 按財務配色規則生成帶公式的 XLSX。 - Agent 按
SKILL.md編排「讀 → 處理 → 寫」，在本地落盤結果文件。
若轉換步驟走 WPS 或 Microsoft Office 引擎，需本機已安裝並可被 Skill 調用的對應套件；純 Python 讀取路徑則不依賴桌面 Office。
適用場景與注意¶
適合誰
- 需要在 CI、內網機或批量任務裏處理 Office 文件、又不想每次手寫多庫腳本的開發者。
- 希望 Agent 統一處理 PDF / DOCX / PPTX / XLSX，且接受離線、文件進出的工作流。
- 做財務類表格交付，需要公式與藍 / 黑 / 綠配色約定的工作簿。
限制與注意
- 雙引擎轉換依賴本機 WPS 或 Microsoft Office 環境，與「零依賴讀取」不是同一層能力，部署時要分開驗證。
- SkillHub 統計（以抓取資料爲準）：評分 100000，下載 2039 次，安裝計數 0；具體行爲仍以你本機安裝的 1.5.1 包內文檔爲準。
- 未覈實到的客戶端專屬配置項不在本文展開；差異安裝路徑以 https://skillhub.cn/install/skillhub.md 爲準。
結尾¶
Office Toolkit 把 Office 批處理收斂爲 Agent 可調用的 Skill：讀取側強調純 Python 跨平臺，表格創建側強調公式與財務配色，轉換側提供 WPS 與 Microsoft Office 雙引擎及 PDF / CSV / JSON 等輸出。若你的場景是批量、離線、自動化的「文件進、文件出」，可從官方包地址或 SkillHub 頁面安裝 @user_5d13378c/office-toolkit-ela 試用。
- https://api.skillhub.cn/user_5d13378c/office-toolkit-ela
- https://www.skillhub.cn/skills/user_5d13378c/office-toolkit-ela
