Communitygithub.com

zhoy0409-debug/scholarflow-skills

ScholarFlow 技能集:適用於文獻回顧、學術寫作、圖表處理、生物資訊學及研究產出的可重複使用代理技能。

scholarflow-skills 是什麼?

此技能為 AI 代理(如 Claude Code、Cursor)提供完整的 PDF 處理能力,包含生成、審閱與驗證。它遵循「視覺優先」的工作流程,利用 `pdftoppm` 將 PDF 頁面渲染為 PNG 以供檢查,確保版面與視覺元素(如圖表、表格與排版)正確無誤。對於程式化 PDF 建立,則使用 `reportlab`;文字擷取與快速驗證則使用 `pdfplumber` 或 `pypdf`,但不將其作為版面正確性的唯一依據。技能明確定義了檔案暫存(`tmp/pdfs/`)與最終輸出(`output/pdf/`)的慣例,並推薦 `uv` 管理相依套件(包括 `reportlab`、`pdfplumber`、`pypdf` 及系統工具 `poppler`)。其品質要求極高,不僅要求視覺上無缺陷(無文字裁切、重疊或詭異字元),還要求一致的排版規範(例如僅使用 ASCII 連字號),並禁止出現工具記號或未清理的佔位符。每次修改後都必須重新渲染檢查,直到確認無視覺瑕疵才算完成。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add zhoy0409-debug/scholarflow-skills

在你喜歡的 AI 中提問

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

說明文件

PDF 處理技能

使用時機

  • 需要閱讀或審閱 PDF 內容,且版面與視覺元素至關重要時。
  • 以程式化方式建立格式可靠的 PDF。
  • 在交付前驗證最終渲染結果。

工作流程

  1. 偏好視覺審查:將 PDF 頁面渲染為 PNG 並進行檢查。
    • 優先使用 pdftoppm。
    • 若無法使用,則安裝 Poppler 或請使用者在本地端審閱輸出。
  2. 建立新文件時,使用 reportlab 產生 PDF。
  3. 文字擷取與快速檢查使用 pdfplumber(或 pypdf);請勿依賴此方法判斷版面精確度。
  4. 每次有意義的更新後,重新渲染頁面並確認對齊、間距及可讀性。

暫存與輸出慣例

  • 使用 tmp/pdfs/ 存放中間檔案;完成後請刪除。
  • 在此儲存庫中工作時,最終成品請寫入 output/pdf/。
  • 保持檔名穩定且具描述性。

相依套件(若缺少請安裝)

偏好使用 uv 管理相依套件。

Python 套件:

uv pip install reportlab pdfplumber pypdf

若無法使用 uv:

python3 -m pip install reportlab pdfplumber pypdf

系統工具(用於渲染):

# macOS (Homebrew)
brew install poppler

# Ubuntu/Debian
sudo apt-get install -y poppler-utils

若在此環境中無法安裝,請告知使用者缺少哪個相依套件,以及如何在本地端安裝。

環境變數

無需任何環境變數。

渲染指令

pdftoppm -png $INPUT_PDF $OUTPUT_PREFIX

品質要求

  • 維持精緻的視覺設計:一致的排版、間距、邊界及章節層次。
  • 避免渲染問題:文字裁切、元素重疊、表格損壞、黑色方塊或無法辨識的字形。
  • 圖表、表格與圖片必須清晰、對齊且標示明確。
  • 僅使用 ASCII 連字號。避免使用 U+2011(不斷行連字號)及其他 Unicode 破折號。
  • 引用與參考文獻必須人類可讀;絕不可留下工具記號或佔位字串。

最終檢查

  • 在最新的 PNG 檢查顯示零視覺或格式缺陷之前,請勿交付。
  • 確認頁首/頁尾、頁碼與章節轉換看起來精美。
  • 保持中間檔案有組織,或在最終批准後將其移除。

相關技能