Communitygithub.com

michellema8890/pdf-to-editable-word-skill

將 PDF 檔案轉換為可編輯的 Word 文件,同時保留原始版面配置,適用於 AI 代理工作流程。

pdf-to-editable-word-skill 是什麼?

此技能提供一個確定性 CLI 工具,能將 PDF 檔案轉換為版面保真度極高的 DOCX 檔案。其核心方法是將清理後的頁面背景與可編輯、絕對定位的文字方塊合併,而非手動重建 OOXML。支援轉換前檢查(inspect)、轉換(convert,可指定工作目錄與 DPI)、中斷後續傳(resume)以及輸出驗證(validate)。轉換前必須檢查 `conversion_ready` 旗標,若為 false 則需查閱 `references/compatibility.md` 了解限制。驗證失敗等同於轉換失敗,不能僅因檔案存在即交付。適用於 AI 代理(如 Claude Code)自動化處理,支援高風險場景下以 Microsoft Word 手動抽查。不支援 OCR、混合頁面尺寸或 LibreOffice 相容性。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add michellema8890/pdf-to-editable-word-skill

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

PDF 轉可編輯 Word 技能

透過結合已清理的頁面背景與可編輯、絕對定位的文字方塊,建立版面忠實的 DOCX。每次轉換皆執行確定性 CLI;請勿手動重建 OOXML。

工作流程

  1. 解析此技能目錄,並使用 scripts/pdf2word.py 作為命令包裝器。
  2. 轉換前檢查來源:
python scripts/pdf2word.py inspect INPUT.pdf --json
  1. 當 conversion_ready 為 false 時,停止並回報限制。請閱讀 compatibility.md 了解相關失敗模式。
  2. 轉換至專屬工作目錄:
python scripts/pdf2word.py convert INPUT.pdf OUTPUT.docx --work-dir WORK_DIR --dpi 144
  1. 若轉換中斷,請使用 --resume 重新執行相同指令。切勿對不同 PDF 或頁面範圍重複使用工作目錄。
  2. 驗證輸出與來源是否一致:
python scripts/pdf2word.py validate OUTPUT.docx --pdf INPUT.pdf --json
  1. 將驗證失敗視為轉換失敗。請勿僅因檔案存在即交付 DOCX。
  2. 針對高風險輸出,請在 Microsoft Word 中開啟結果,檢查第一頁、中間頁、最後頁以及版面特殊頁面。

交付

回報輸出路徑、頁數、可編輯文字方塊數、背景圖片數、驗證結果以及任何相容性警告。清楚說明文字可編輯,但非文字圖形仍位於頁面背景中。

請勿宣稱表格、圖表或圖片可語意編輯。請勿宣稱 v0.1 支援 OCR、混合頁面尺寸或 LibreOffice 相容性。

相關技能