前言¶
日常開發或運維裏，PDF 往往散落在腳本、桌面工具和一次性命令之間：合併幾份合同、從掃描件裏摳文字、批量轉成 Word 或圖片，每換一類操作就要換一套工具或查一遍參數。把能力收進一個 Agent Skill，可以在對話裏按任務描述讓模型按統一流程執行，減少反覆切換環境。
下面介紹 SkillHub 上的社區 Skill「精簡PDF處理工具包」（座標 @user_05cc33a7/pdf-fast-handler-skill，當前版本 1.0.1），面向辦公自動化、格式轉換、文檔整理和掃描件處理等高頻場景。
這是什麼¶
「精簡PDF處理工具包」是一款輕量、面向 PDF 的 Agent Skill，以通用 SKILL.md 形式發佈，由社區用戶 user_05cc33a7 維護，在 SkillHub 分類爲 office-efficiency，來源標記爲 community。官方頁面說明其集成文本提取、合併拆分、格式轉換、頁面編輯、安全與壓縮、批量處理等能力，目標是在 Agent 對話中完成常見 PDF 操作，而不必爲每個子任務單獨找 CLI。
Skill 標籤標明 requires_api_key=false，即按 SkillHub 展示信息，不依賴額外 API Key 即可安裝使用（具體仍取決於 Skill 內部是否調用本機工具或第三方庫，以安裝後的 SKILL.md 爲準）。
核心功能¶
以下能力均來自 SkillHub 官方簡介，按用途歸類，便於對照需求選型。
內容與識別
- 文本提取、文件信息查詢
- OCR 圖文識別、掃描版 PDF 轉文字
- 圖片提取、表格提取、書籤提取、批註提取
格式轉換
- PDF 轉 Word、圖片、HTML、TXT、Markdown
- 多張圖片合成 PDF、Word 轉 PDF
- 批量轉 Word、批量轉圖片、批量 Word 轉 PDF
文檔編輯
- PDF 合併、拆分
- 頁面旋轉、刪除頁碼、提取頁面、插入頁面、替換頁面、頁面反轉
- 頁眉頁腳、自動頁碼、水印添加
安全與維護
- PDF 加密、解密
- 文件壓縮、文檔修復
- 批量處理（總稱，與上述批量轉換能力並列出現在官方說明中）
先做能力對齊，再在對話裏點名具體任務，比一次性羅列全部動詞更符合實際使用方式。
安裝與啓用¶
SkillHub 官方推薦兩種方式：用 CLI 安裝，或把安裝提示詞發給當前使用的 AI，讓其按 SkillHub 安裝文檔操作。
1、確認 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
2、安裝本 Skill 到當前 Agent 的 skills 目錄
安裝時必須用 --dir 指向當前 Agent 識別的 skills 目錄；否則默認落在 ./skills/，Agent 可能無法加載。SkillHub 文檔給出的常見路徑包括：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
安裝命令示例（將 <skills 目錄> 換成上面對應路徑）：
skillhub install @user_05cc33a7/pdf-fast-handler-skill --dir <skills 目錄>
也可在對話中發送官方頁面提供的提示詞，讓 AI 按文檔安裝：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_05cc33a7/pdf-fast-handler-skill`。
3、啓用與刷新
安裝完成後，按你所用 Client 的慣例重啓或刷新 Agent，使其讀取新 Skill。具體觸發方式因 Client 而異，以各產品當前文檔爲準。
典型用法¶
本 Skill 沒有在本次資料中附帶可複製的獨立腳本示例；用法遵循 Agent Skill 的常規模式：安裝並啓用後，在對話中說明輸入文件、期望輸出和約束，由 Agent 根據 SKILL.md 中的步驟調用相應處理方式。
可復現的「安裝側」示例即上一節的 skillhub install 與官方提示詞。業務側可按官方能力列表組織請求，例如：
- 指明本地或工作區內的 PDF 路徑，以及輸出目錄或文件名。
- 說明單一操作（如「合併這兩個 PDF」「把第 3–5 頁拆成新文件」）或批量任務（如「目錄下所有 PDF 轉圖片」）。
- 對掃描件補充是否需要 OCR 或「掃描版轉文字」，避免與純文本 PDF 的提取混淆。
經過上面的步驟，Agent 應在 Skill 規則範圍內執行；若某次任務超出 Skill 聲明能力，以對話中 Agent 的說明爲準，必要時回到 SkillHub 頁面覈對版本是否爲 v1.0.1。
適用場景與注意¶
適合誰
- 經常在 Cursor、Claude Code、Codex 等支持 Skills 的環境裏處理 PDF 的開發者或辦公用戶。
- 需要合併、拆分、轉格式、加水印、頁碼與頁眉頁腳等重複性操作，希望用自然語言驅動而非記憶多套命令的場景。
- 掃描件、表格、批註等需要從 PDF 中結構化取出的整理工作（以 Skill 實際實現爲準）。
使用注意
- 社區來源（
community）意味着維護節奏與上游工具鏈以發佈者更新爲準；升級可用skillhub對同一座標做更新，並關注 SkillHub 上的版本號。 - 大文件、加密 PDF、複雜版式轉換的效果取決於 Skill 依賴的本機組件；資料未列出具體依賴時，應在首次使用前在小樣本上試跑。
- 涉及加密、解密與批處理時，注意備份原文件，並在共享倉庫或日誌中避免泄露敏感路徑與內容。
- SkillHub 頁面統計（截至資料抓取）：評分 100000，下載 17050，安裝 265；與線索中的其他數字不一致時，以 SkillHub 頁面與 API 抓取字段爲準。
結尾¶
「精簡PDF處理工具包」把 PDF 相關的提取、轉換、頁面編輯、安全與批量能力收攏到一個 Skill 座標裏，適合在 Agent 工作流裏用對話代替零散腳本。若你需要在本地 Client 中試用，可從 SkillHub 官方頁獲取安裝提示與版本信息：
- Skill 頁面：https://www.skillhub.cn/skills/user_05cc33a7/pdf-fast-handler-skill
- 安裝說明：https://skillhub.cn/install/skillhub.md
- 座標：
@user_05cc33a7/pdf-fast-handler-skill（v1.0.1）
