如何把 PDF 變成 AI 知識庫？Book to Skill 完整使用教學（2026）

最後更新於 2026 年 8 月 3 日。技術細節已對照 book-to-skill 官方倉庫與 Agent Skills 開放標準。

你買了《設計資料密集型應用》或團隊內部架構規範 PDF，讀的時候覺得醍醐灌頂，三個月後寫程式卻想不起第七章講過什麼。在 PDF 裡全文搜尋只能得到頁碼；把整本書貼進 Cursor 對話會迅速吃光上下文；自己整理的筆記又很少再打開。

Book to Skill 走另一條路：把 PDF（或 EPUB、DOCX、Markdown 資料夾）一次性蒸餾成符合 Agent Skills 標準的結構化技能包。之後在 Cursor、Claude Code 或 GitHub Copilot CLI 裡，Agent 只載入與當前問題相關的章節，用作者原話裡的框架和術語回答。

本文按「先理解價值 → 再裝環境 → 跑通轉換 → 日常呼叫」的順序，給出 2026 年可用的完整實操路徑。若團隊正在評估向量資料庫方案，建議先讀比較章節再決定是否投入。

為何要把 PDF 變成 AI 知識庫

一般 RAG 把 PDF 切成碎片向量，問什麼檢索什麼。對 FAQ、合約條款很有效，但對技術書往往不夠：價值在於作者命名的框架、決策樹和反模式。

官方基準測試顯示，相比整書塞進上下文，按需載入可節省約 24×–51× Token；轉換一次性成本約 1 美元/本（Claude Sonnet 計價）。

擷取書名、作者、章節樹與核心心智模型
每章 800–1,200 token 實操摘要（技術書保留表格結構）
額外生成術語表、模式清單與決策速查表
SKILL.md 只放索引，章節檔按需載入

Book to Skill 是什麼

book-to-skill 是開源 Python 專案（MIT）。推薦 clone 到 ~/.cursor/skills-cursor/ 後在對話執行 /book-to-skill ./my-book.pdf。

支援 PDF、EPUB、DOCX、TXT、Markdown 等，也可指向資料夾或 glob 合併多份文件。

Book to Skill 從 PDF 到 Agent Skill 流程 — 擷取 → 結構化 → SKILL.md 與章節 → 按需載入

三種方案怎麼選

方案	優點	缺點	適合誰
整書貼進對話	零設定	Token 爆炸	一次性問答
向量 RAG	海量文件、可增量	難保留全書框架	企業知識庫
Book to Skill	保留作者框架；章節按需	需一次性轉換	技術書、Runbook

若你反覆查閱同一本技術書，且希望 Cursor 寫碼時引用書中決策規則，Book to Skill 通常是性價比最高的選擇。若已使用 GitHub MCP Server 如何部署？Windows、Linux、macOS 全平台教學連接倉庫，可把架構原則與真實程式碼放在同一 Agent 工作流。

環境準備

git clone https://github.com/virgiliojr94/book-to-skill.git
cd book-to-skill
python3 scripts/extract.py --check

Scanned PDFs without a text layer will fail—OCR first or use EPUB.

安裝 Book to Skill

git clone https://github.com/virgiliojr94/book-to-skill.git \
  ~/.cursor/skills-cursor/book-to-skill

完整轉換流程

/book-to-skill ~/Books/ddia.pdf designing-data-intensive-apps

Pick technical for code-heavy books (Docling). Confirm the ~$1/book cost preview before generation. Run on a host that will not sleep; 300–500 page PDFs may take many minutes.

生成物長什麼樣

~/.cursor/skills-cursor/designing-data-intensive-apps/
├── SKILL.md
├── chapters/ch01-*.md …
├── glossary.md
└── cheatsheet.md

日常怎麼用

/designing-data-intensive-apps replication
/designing-data-intensive-apps ch05

典型場景：「我要給訂單服務加快取，按 DDIA 建議對照一致性模型。」Agent 會讀取 cheatsheet.md 與相關章節。

With MCP tools, combine book logic with live repo facts—same pattern as OpenShip 部署失敗：2026 構建與上線排障指南.

進階用法

/book-to-skill ~/papers/*.pdf ~/notes/architecture.md team-knowledge

Skill folders are Markdown—commit to .cursor/skills/ for team sharing. Use analyze-only mode to preview chapter trees before full generation.

故障排查

Symptom	Cause	Fix
Zero chapters	No Chapter N headings	EPUB or manual sections
Garbled code	text-heavy on technical book	Docling + technical
`/book-to-skill` missing	Wrong path	`~/.cursor/skills-cursor/`

Summary

快速上手：clone → /book-to-skill your.pdf → Docling
長期複用：技能目錄納入 Git
省 Token：章節按需載入

Book to Skill 把「讀過但記不住」變成「寫程式時隨時可問的作者框架」。批量轉換建議使用持續線上的雲端 Mac，避免合蓋中斷。

FAQ

與向量 RAG 的差別？

RAG 檢索片段；Book to Skill 結構化蒸餾後按主題載入整章摘要。

必須用 Claude？

轉換階段由 Claude 驅動；產出 Markdown 任意模型可用。

掃描版 PDF？

需 OCR 或改用 EPUB。

轉換費用？

約 1 美元/本，之後僅消耗按需章節 Token。