https://chihhung.github.io/Blog/tags/knowledge-engineering/Recent content in Knowledge Engineering on Eric 個人部落格Hugozh-TWTue, 04 Aug 2026 12:03:34 +0800https://chihhung.github.io/Blog/posts/%E6%95%99%E5%AD%B8/ai%E9%96%8B%E7%99%BC/book-to-skill-%E6%95%99%E5%AD%B8%E6%89%8B%E5%86%8A/Tue, 04 Aug 2026 12:03:34 +0800https://chihhung.github.io/Blog/posts/%E6%95%99%E5%AD%B8/ai%E9%96%8B%E7%99%BC/book-to-skill-%E6%95%99%E5%AD%B8%E6%89%8B%E5%86%8A/<h1 id="book-to-skill-教學手冊">book-to-skill 教學手冊</h1> <blockquote> <p><strong>book-to-skill — 把一本書、一份文件、甚至一整個 <code>docs/</code> 資料夾，轉成 AI Agent 可隨查隨用的 「Skill」：Claude Code、GitHub Copilot CLI、Amp 三大 host 共用的知識轉換引擎</strong> 適用對象：資深工程師、AI Engineer、知識工程／RAG 團隊、Tech Lead、架構師、企業導入人員、PM 文件性質：企業內部「Knowledge-as-Skill」知識庫導入、開發與維運培訓教材 版本基準：book-to-skill（<code>virgiliojr94/book-to-skill</code>，2026 年 5 月 1 日建立、核心 MIT License、 v1.3.0 正式版於 2026-07-30 發布；本次改版核校時間點 2026-08-04）</p></blockquote> <hr> <h2 id="-重要聲明請務必先讀">⚠️ 重要聲明（請務必先讀）</h2> <ol> <li><strong>book-to-skill 仍在高速迭代中。</strong> 本專案於 2026-05-01 建立，短短三個月內成長迅速，已登上 GitHub Trendshift 趨勢榜（編號 #27038）。截至本次改版核校（2026-08-04，直接呼叫 <code>api.github.com/repos/virgiliojr94/book-to-skill</code> 查證，非憑記憶）已有 <strong>16,048 Stars、 1,714 Forks、81 Subscribers、18 個開放 Issue</strong>，版本從 v1.0.0（2026-06-08）快速推進到 v1.3.0（2026-07-30，<code>pyproject.toml</code> 版本號同步為 <code>1.3.0</code>，最後一次 push 為 2026-07-31）。 <strong>其 CLI 參數、SKILL.md 內部步驟、目錄結構在版本之間可能持續變動，任何指令與檔名在正式導入前， 務必以最新官方 Repository 為準；本手冊所列數字僅為核校當下快照。</strong></li> <li><strong>本手冊的定位是「理解、彙整、分析、重組、補充最佳實務」，而非官方文件翻譯。</strong> 依撰寫要求，本書 不直接翻譯 README、不大量抄錄原文，而是以企業教育訓練教材的角度重新組織、加入架構圖、比較表、 最佳實務與導入建議。</li> <li><strong>內容分兩類：</strong> <ul> <li><strong>官方已確認事實</strong>（例如 <code>book_to_skill/</code> pip 套件結構、<code>scripts/extract.py</code> 薄殼層、 <code>SKILL.md</code> 規格文件本身驅動 Step 0–10 的生成流程、<code>tools/discovery_tax.py</code>／ <code>tools/validate_skill.py</code>／<code>tools/scan_generated_skill.py</code> 三支輔助工具、<code>sanitize.py</code> 的 隱藏字元清洗機制等）作為骨幹，內文一律使用 repo 內<strong>實際檔名／路徑／指令</strong>，不使用意譯替代。 本次核校已透過 GitHub API 直接讀取 repo 檔案樹、<code>README.md</code>、<code>SKILL.md</code>、 <code>docs/ARCHITECTURE.md</code>、<code>pyproject.toml</code>、<code>book_to_skill/config.py</code> 等原始檔案逐一比對， 非僅憑記憶或二手轉述。</li> <li><strong>作者補充</strong>：凡屬作者依企業（含金融業、保險業）導入 AI Agent 知識工程之實務經驗所補充或推論 之處，會標註 <strong>（作者建議）</strong> 或 <strong>（作者推論）</strong>。這些是最佳實務參考，非官方保證。</li> </ul> </li> <li><strong>特別澄清（避免讀者對架構產生誤解）：</strong> <ul> <li>book-to-skill <strong>不是</strong>一個獨立呼叫 Anthropic／OpenAI API 的雲端服務，它本身<strong>沒有</strong>也<strong>不需要</strong> 設定任何 LLM API Key——真正執行「閱讀全文、萃取框架、寫出 <code>SKILL.md</code>」這些生成工作的模型， 是使用者當下所在的 <strong>host agent</strong>（Claude Code、GitHub Copilot CLI、或 Amp）本身。book-to-skill 提供的是一份規格文件（<code>SKILL.md</code>）加一組確定性的文字擷取程式（<code>book_to_skill/</code> 套件），並不是 另一個會發送 API 請求的後端服務。</li> <li>book-to-skill <strong>不是</strong> MCP（Model Context Protocol）Server，repo 中沒有 MCP 相關程式碼。它遵循 的是另一個開放標準——<strong>Agent Skills 標準</strong>（<code>agentskills/agentskills</code>），與 MCP 是兩種不同的 擴充機制，兩者可以並存但不是同一件事。第13章會詳細釐清這個常見誤解。</li> <li>這兩點都與坊間許多「AI 開發工具教學範本」預設的雲端服務／MCP 整合章節不同，本手冊會在對應章節 明確標註「此工具不適用」而非硬套範本。</li> </ul> </li> <li><strong>授權條款請留意「範圍界線」：</strong> book-to-skill 轉換器本身（程式碼 + <code>SKILL.md</code> 規格）採 <strong>MIT License</strong>，可自由商用、修改、內部散布。但這<strong>不代表</strong>經過 book-to-skill 處理過的書籍／文件內容 本身的著作權也隨之開放——官方 README 明確指出：book-to-skill 不隨附任何書籍內容、不上傳使用者的 檔案，產生的 Skill 是「你自己的讀書筆記」性質的衍生摘要，<strong>不可對外散布第三方受著作權保護書籍所 產生的 Skill</strong>；公司內部文件、自有著作、開放授權素材則可依其授權範圍分享。金融業、保險業等受 監理產業，導入前應將此授權界線一併提交法務／智財單位確認（<strong>作者建議</strong>）。</li> <li>官方權威來源請見〈附錄 A・References〉。</li> </ol> <hr> <h2 id="目錄table-of-contents">目錄（Table of Contents）</h2> <!-- TOC-AUTO-BEGIN --> <ul> <li><a href="#%E5%9C%96%E4%BE%8B%E8%88%87%E7%AC%A6%E8%99%9F%E8%AA%AA%E6%98%8E">圖例與符號說明</a></li> <li><a href="#%E6%9C%AC%E6%89%8B%E5%86%8A%E9%96%B1%E8%AE%80%E8%B7%AF%E5%BE%91">本手冊閱讀路徑</a></li> <li><a href="#%E7%AC%AC1%E7%AB%A0-book-to-skill-%E6%98%AF%E4%BB%80%E9%BA%BC">第1章 book-to-skill 是什麼</a> <ul> <li><a href="#11-%E4%B8%80%E5%8F%A5%E8%A9%B1%E5%AE%9A%E7%BE%A9">1.1 一句話定義</a></li> <li><a href="#12-%E7%99%BC%E5%B1%95%E8%83%8C%E6%99%AF%E8%88%87%E8%AA%95%E7%94%9F%E8%84%88%E7%B5%A1">1.2 發展背景與誕生脈絡</a></li> <li><a href="#13-%E8%A8%AD%E8%A8%88%E7%90%86%E5%BF%B5">1.3 設計理念</a></li> <li><a href="#14-%E8%A7%A3%E6%B1%BA%E5%93%AA%E4%BA%9B%E5%95%8F%E9%A1%8Cdiscovery-loop-tax%E6%A0%B8%E5%BF%83%E8%B3%A3%E9%BB%9E">1.4 解決哪些問題：Discovery Loop Tax（核心賣點）</a></li> <li><a href="#15-%E9%81%A9%E7%94%A8%E6%83%85%E5%A2%83">1.5 適用情境</a></li> <li><a href="#16-%E9%99%90%E5%88%B6">1.6 限制</a></li> <li><a href="#17-%E7%89%B9%E8%89%B2">1.7 特色</a></li> <li><a href="#18-%E5%84%AA%E9%BB%9E">1.8 優點</a></li> <li><a href="#19-%E7%BC%BA%E9%BB%9E">1.9 缺點</a></li> <li><a href="#110-%E8%88%87%E5%82%B3%E7%B5%B1-rag-%E7%9A%84%E5%B7%AE%E7%95%B0">1.10 與傳統 RAG 的差異</a></li> <li><a href="#111-%E8%88%87%E5%90%91%E9%87%8F%E8%B3%87%E6%96%99%E5%BA%AB%E7%9A%84%E5%B7%AE%E7%95%B0">1.11 與向量資料庫的差異</a></li> <li><a href="#112-%E8%88%87-mcp-%E7%9A%84%E5%B7%AE%E7%95%B0">1.12 與 MCP 的差異</a></li> <li><a href="#113-%E8%88%87claude-skills%E7%9A%84%E9%97%9C%E4%BF%82">1.13 與「Claude Skills」的關係</a></li> <li><a href="#114-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">1.14 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC2%E7%AB%A0-%E7%B3%BB%E7%B5%B1%E6%9E%B6%E6%A7%8B">第2章 系統架構</a> <ul> <li><a href="#21-%E6%9E%B6%E6%A7%8B%E7%B8%BD%E8%A6%BD%E5%85%A9%E5%80%8B%E5%8D%8A%E9%83%A8">2.1 架構總覽：兩個半部</a></li> <li><a href="#22-%E8%B3%87%E6%96%99%E6%B5%81data-flow">2.2 資料流（Data Flow）</a></li> <li><a href="#23-knowledge-flow%E7%9F%A5%E8%AD%98%E8%90%83%E5%8F%96%E7%9A%84%E5%88%86%E5%B1%A4%E9%82%8F%E8%BC%AF">2.3 Knowledge Flow（知識萃取的分層邏輯）</a></li> <li><a href="#24-skill-generation-pipelineskillmd-%E9%A9%85%E5%8B%95%E7%9A%84-step-010">2.4 Skill Generation Pipeline（SKILL.md 驅動的 Step 0–10）</a></li> <li><a href="#25-document-processing-%E6%B1%BA%E7%AD%96%E6%A8%B9">2.5 Document Processing 決策樹</a></li> <li><a href="#26-prompt-pipeline%E5%9B%9B%E7%A8%AE%E6%93%8D%E4%BD%9C%E6%A8%A1%E5%BC%8F">2.6 Prompt Pipeline：四種操作模式</a></li> <li><a href="#27-%E7%AB%AF%E5%88%B0%E7%AB%AF%E8%B3%87%E6%96%99%E6%B5%81%E7%B8%BD%E7%B5%90%E5%9C%96">2.7 端到端資料流總結圖</a></li> <li><a href="#28-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">2.8 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC3%E7%AB%A0-book-to-skill-%E6%A0%B8%E5%BF%83%E6%9E%B6%E6%A7%8B%E8%A9%B3%E8%A7%A3">第3章 book-to-skill 核心架構詳解</a> <ul> <li><a href="#31-parser%E8%A7%A3%E6%9E%90%E5%99%A8">3.1 Parser（解析器）</a></li> <li><a href="#32-layout-detection%E7%AB%A0%E7%AF%80%E7%9B%AE%E9%8C%84%E5%81%B5%E6%B8%AC">3.2 Layout Detection（章節／目錄偵測）</a></li> <li><a href="#33-knowledge-extraction%E7%9F%A5%E8%AD%98%E8%90%83%E5%8F%96agent-%E5%81%B4">3.3 Knowledge Extraction（知識萃取，Agent 側）</a></li> <li><a href="#34-skill-generator">3.4 Skill Generator</a></li> <li><a href="#35-metadata">3.5 Metadata</a></li> <li><a href="#36-output%E8%BC%B8%E5%87%BA%E7%B5%90%E6%A7%8B">3.6 Output（輸出結構）</a></li> <li><a href="#37-cli">3.7 CLI</a></li> <li><a href="#38-config">3.8 Config</a></li> <li><a href="#39-cache%E8%AA%A0%E5%AF%A6%E8%AA%AA%E6%98%8E%E6%B2%92%E6%9C%89%E6%8C%81%E4%B9%85%E5%8C%96%E5%BF%AB%E5%8F%96">3.9 Cache（誠實說明：沒有持久化快取）</a></li> <li><a href="#310-log%E8%AA%A0%E5%AF%A6%E8%AA%AA%E6%98%8E%E6%B2%92%E6%9C%89%E7%B5%90%E6%A7%8B%E5%8C%96-logging-%E6%A1%86%E6%9E%B6">3.10 Log（誠實說明：沒有結構化 Logging 框架）</a></li> <li><a href="#311-error-handling">3.11 Error Handling</a></li> <li><a href="#312-pluginextension%E8%AA%A0%E5%AF%A6%E8%AA%AA%E6%98%8E%E6%B2%92%E6%9C%89%E5%9F%B7%E8%A1%8C%E6%9C%9F-plugin-%E6%A9%9F%E5%88%B6%E4%BD%86%E6%9C%89%E6%98%8E%E7%A2%BA%E7%9A%84%E6%93%B4%E5%85%85%E8%B7%AF%E5%BE%91">3.12 Plugin／Extension（誠實說明：沒有執行期 Plugin 機制，但有明確的擴充路徑）</a></li> <li><a href="#313-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">3.13 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC4%E7%AB%A0-%E5%AE%89%E8%A3%9D">第4章 安裝</a> <ul> <li><a href="#41-%E5%85%A9%E7%A8%AE%E5%AE%89%E8%A3%9D%E8%B7%AF%E5%BE%91%E5%85%88%E5%88%86%E6%B8%85%E6%A5%9A%E5%86%8D%E5%8B%95%E6%89%8B">4.1 兩種安裝路徑，先分清楚再動手</a></li> <li><a href="#42-windows-%E5%AE%89%E8%A3%9D">4.2 Windows 安裝</a></li> <li><a href="#43-linux-%E5%AE%89%E8%A3%9D">4.3 Linux 安裝</a></li> <li><a href="#44-macos-%E5%AE%89%E8%A3%9D">4.4 macOS 安裝</a></li> <li><a href="#45-wsl-%E5%AE%89%E8%A3%9D">4.5 WSL 安裝</a></li> <li><a href="#46-%E5%90%84-host-%E5%AE%89%E8%A3%9D%E6%8C%87%E4%BB%A4%E5%B0%8D%E7%85%A7">4.6 各 Host 安裝指令對照</a></li> <li><a href="#47-pip-%E5%AE%89%E8%A3%9D%E7%8D%A8%E7%AB%8B-cli">4.7 pip 安裝（獨立 CLI）</a></li> <li><a href="#48-uv-%E5%AE%89%E8%A3%9D%E4%BD%9C%E8%80%85%E5%BB%BA%E8%AD%B0">4.8 uv 安裝（作者建議）</a></li> <li><a href="#49-nodegit-%E7%AD%89%E5%89%8D%E7%BD%AE%E9%9C%80%E6%B1%82">4.9 Node／Git 等前置需求</a></li> <li><a href="#410-%E4%BC%81%E6%A5%AD%E5%AE%89%E8%A3%9Doffline-%E5%AE%89%E8%A3%9D%E4%BD%9C%E8%80%85%E5%BB%BA%E8%AD%B0">4.10 企業安裝：Offline 安裝（作者建議）</a></li> <li><a href="#411-proxyfirewall-%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A0%85%E4%BD%9C%E8%80%85%E5%BB%BA%E8%AD%B0">4.11 Proxy／Firewall 注意事項（作者建議）</a></li> <li><a href="#412-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">4.12 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC5%E7%AB%A0-%E8%A8%AD%E5%AE%9A">第5章 設定</a> <ul> <li><a href="#51-%E8%A8%AD%E5%AE%9A%E6%A9%9F%E5%88%B6%E7%B8%BD%E8%A6%BD%E8%AA%A0%E5%AF%A6%E6%BE%84%E6%B8%85%E6%B2%92%E6%9C%89-yamljson-%E8%A8%AD%E5%AE%9A%E6%AA%94">5.1 設定機制總覽（誠實澄清：沒有 YAML/JSON 設定檔）</a></li> <li><a href="#52-cli-%E5%8F%83%E6%95%B8">5.2 CLI 參數</a></li> <li><a href="#53-%E7%92%B0%E5%A2%83%E8%AE%8A%E6%95%B8">5.3 環境變數</a></li> <li><a href="#54-api-key%E6%98%8E%E7%A2%BA%E6%BE%84%E6%B8%85%E4%B8%8D%E9%9C%80%E8%A6%81%E8%A8%AD%E5%AE%9A">5.4 API Key：明確澄清「不需要設定」</a></li> <li><a href="#55-%E5%90%84-host-%E7%9A%84%E6%A8%A1%E5%9E%8B%E5%BE%9E%E4%BD%95%E8%80%8C%E4%BE%86">5.5 各 Host 的模型從何而來</a></li> <li><a href="#56-mkdocsyml%E5%AE%98%E6%96%B9%E6%96%87%E4%BB%B6%E7%AB%99%E8%A8%AD%E5%AE%9A%E9%9D%9E%E4%BD%BF%E7%94%A8%E8%80%85%E9%9C%80%E8%A8%AD%E5%AE%9A%E9%A0%85">5.6 mkdocs.yml：官方文件站設定（非使用者需設定項）</a></li> <li><a href="#57-%E6%9C%80%E4%BD%B3%E8%A8%AD%E5%AE%9A%E5%BB%BA%E8%AD%B0%E4%BD%9C%E8%80%85%E5%BB%BA%E8%AD%B0">5.7 最佳設定建議（作者建議）</a></li> <li><a href="#58-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">5.8 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC6%E7%AB%A0-%E6%96%87%E4%BB%B6%E6%A0%BC%E5%BC%8F%E6%94%AF%E6%8F%B4">第6章 文件格式支援</a> <ul> <li><a href="#61-%E6%94%AF%E6%8F%B4%E6%A0%BC%E5%BC%8F%E7%B8%BD%E8%A1%A8">6.1 支援格式總表</a></li> <li><a href="#62-pdf%E6%8A%80%E8%A1%93%E6%9B%B8-vs-%E6%96%87%E5%AD%97%E6%9B%B8%E7%9A%84%E5%8F%96%E6%8D%A8">6.2 PDF：技術書 vs. 文字書的取捨</a></li> <li><a href="#63-epub">6.3 EPUB</a></li> <li><a href="#64-docxoffice-%E6%A0%BC%E5%BC%8F">6.4 DOCX（Office 格式）</a></li> <li><a href="#65-%E7%B4%94%E6%96%87%E5%AD%97%E7%B3%BB%E5%88%97txtmarkdownrstasciidoc">6.5 純文字系列（TXT／Markdown／RST／AsciiDoc）</a></li> <li><a href="#66-rtf">6.6 RTF</a></li> <li><a href="#67-mobiazwazw3">6.7 MOBI／AZW／AZW3</a></li> <li><a href="#68-%E4%B8%8D%E5%90%8C%E4%BC%81%E6%A5%AD%E6%96%87%E4%BB%B6%E9%A1%9E%E5%9E%8B%E7%9A%84%E5%AF%A6%E5%8B%99%E5%B0%8D%E6%87%89%E4%BD%9C%E8%80%85%E5%BB%BA%E8%AD%B0">6.8 不同企業文件類型的實務對應（作者建議）</a></li> <li><a href="#69-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">6.9 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC7%E7%AB%A0-document-parsing-%E8%88%87-layout-analysis-%E6%B7%B1%E5%85%A5">第7章 Document Parsing 與 Layout Analysis 深入</a> <ul> <li><a href="#71-layout-analysis-%E7%B8%BD%E8%A6%BD">7.1 Layout Analysis 總覽</a></li> <li><a href="#72-%E7%AB%A0%E7%AF%80%E8%BE%A8%E8%AD%98heading-detection">7.2 章節辨識（Heading Detection）</a></li> <li><a href="#73-tablecode-block-%E6%93%B7%E5%8F%96">7.3 Table／Code Block 擷取</a></li> <li><a href="#74-imagecaptionfootnotereferencecitation-%E7%9A%84%E8%99%95%E7%90%86%E9%99%90%E5%88%B6%E8%AA%A0%E5%AF%A6%E8%AA%AA%E6%98%8E">7.4 Image／Caption／Footnote／Reference／Citation 的處理限制（誠實說明）</a></li> <li><a href="#75-%E5%AE%89%E5%85%A8%E9%98%B2%E8%AD%B7%E6%96%87%E4%BB%B6context-%E4%BE%9B%E6%87%89%E9%8F%88%E7%9A%84%E4%B8%89%E9%81%93%E9%98%B2%E7%B7%9A">7.5 安全防護：文件→Context 供應鏈的三道防線</a></li> <li><a href="#76-%E6%9C%80%E4%BD%B3%E5%AF%A6%E5%8B%99">7.6 最佳實務</a></li> <li><a href="#77-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">7.7 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC8%E7%AB%A0-knowledge-extraction%E7%9F%A5%E8%AD%98%E8%90%83%E5%8F%96">第8章 Knowledge Extraction（知識萃取）</a> <ul> <li><a href="#81-step-3%E5%88%86%E6%9E%90%E6%9B%B8%E7%B1%8D%E7%B5%90%E6%A7%8B%E5%9B%9E%E9%A1%A7%E8%88%87%E5%B1%95%E9%96%8B">8.1 Step 3：分析書籍結構（回顧與展開）</a></li> <li><a href="#82-step-4%E8%A9%A2%E5%95%8F%E7%94%A8%E9%80%94%E6%8E%A8%E5%B0%8E-depth">8.2 Step 4：詢問用途，推導 DEPTH</a></li> <li><a href="#83-quality-rules%E5%85%AB%E6%A2%9D%E5%93%81%E8%B3%AA%E6%BA%96%E5%89%87%E9%87%8D%E6%96%B0%E8%A9%AE%E9%87%8B">8.3 Quality Rules：八條品質準則（重新詮釋）</a></li> <li><a href="#84-%E5%85%AD%E7%A8%AE%E7%9F%A5%E8%AD%98%E5%BD%A2%E6%85%8B%E8%88%87%E6%A8%A1%E6%9D%BF%E6%AC%84%E4%BD%8D%E5%B0%8D%E7%85%A7">8.4 六種知識形態與模板欄位對照</a></li> <li><a href="#85-%E6%A1%88%E4%BE%8B%E5%A6%82%E6%9E%9C%E6%8A%8A%E7%B6%93%E5%85%B8%E6%9E%B6%E6%A7%8B%E6%9B%B8%E4%B8%9F%E9%80%B2-book-to-skill">8.5 案例：如果把經典架構書丟進 book-to-skill</a></li> <li><a href="#86-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">8.6 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC9%E7%AB%A0-skill-generationskill-%E7%94%A2%E5%87%BA%E8%A6%8F%E6%A0%BC">第9章 Skill Generation（Skill 產出規格）</a> <ul> <li><a href="#91-skillmd-%E4%B8%BB%E6%AA%94%E6%A8%A1%E6%9D%BF%E7%B5%90%E6%A7%8B">9.1 <code>SKILL.md</code> 主檔模板結構</a></li> <li><a href="#92-cross-agent-%E7%9B%B8%E5%AE%B9%E6%80%A7%E8%A8%AD%E8%A8%88agent-neutral-%E5%AF%AB%E6%B3%95">9.2 Cross-agent 相容性設計（agent-neutral 寫法）</a></li> <li><a href="#93-chapterschnn-slugmd-%E6%A8%A1%E6%9D%BF%E9%80%90%E7%AF%80%E8%AA%AA%E6%98%8E">9.3 <code>chapters/ch&lt;NN&gt;-&lt;slug&gt;.md</code> 模板逐節說明</a></li> <li><a href="#94-%E6%94%AF%E6%8F%B4%E6%AA%94%E6%A1%88glossarypatternscheatsheet">9.4 支援檔案：glossary／patterns／cheatsheet</a></li> <li><a href="#95-updatefold-in-workflowmode-4%E6%B7%B1%E5%85%A5">9.5 Update／Fold-in Workflow（Mode 4）深入</a></li> <li><a href="#96-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">9.6 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC10%E7%AB%A0-claude-code-%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8">第10章 Claude Code 如何使用</a> <ul> <li><a href="#101-%E5%AE%89%E8%A3%9D%E8%88%87%E5%9F%BA%E6%9C%AC%E4%BD%BF%E7%94%A8%E5%9B%9E%E9%A1%A7">10.1 安裝與基本使用回顧</a></li> <li><a href="#102-%E8%88%87-claude-skills-%E6%A9%9F%E5%88%B6%E7%9A%84%E9%97%9C%E4%BF%82">10.2 與 Claude Skills 機制的關係</a></li> <li><a href="#103-%E8%88%87-claudemdmemory-%E9%AB%94%E7%B3%BB%E6%95%B4%E5%90%88%E4%BD%9C%E8%80%85%E5%BB%BA%E8%AD%B0">10.3 與 <code>CLAUDE.md</code>／Memory 體系整合（作者建議）</a></li> <li><a href="#104-context-%E8%BC%89%E5%85%A5%E8%A1%8C%E7%82%BA">10.4 Context 載入行為</a></li> <li><a href="#105-%E8%88%87-subagentagent-%E6%9E%B6%E6%A7%8B%E6%90%AD%E9%85%8D">10.5 與 Subagent／Agent 架構搭配</a></li> <li><a href="#106-%E8%88%87%E6%97%A2%E6%9C%89-workflowslash-command-%E6%95%B4%E5%90%88">10.6 與既有 Workflow／Slash Command 整合</a></li> <li><a href="#107-%E6%9C%80%E4%BD%B3%E5%AF%A6%E5%8B%99">10.7 最佳實務</a></li> <li><a href="#108-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">10.8 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC11%E7%AB%A0-github-copilot-cli-%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8">第11章 GitHub Copilot CLI 如何使用</a> <ul> <li><a href="#111-%E5%AE%89%E8%A3%9D%E8%88%87-reload">11.1 安裝與 Reload</a></li> <li><a href="#112-%E8%88%87-custom-instructionscopilot-instructionsmd%E7%9A%84%E5%88%86%E5%B7%A5">11.2 與 Custom Instructions（<code>copilot-instructions.md</code>）的分工</a></li> <li><a href="#113-prompt-files-%E5%B0%8D%E7%85%A7%E4%BD%9C%E8%80%85%E5%BB%BA%E8%AD%B0%E5%BB%B6%E4%BC%B8">11.3 Prompt Files 對照（作者建議延伸）</a></li> <li><a href="#114-project-local-%E5%AE%89%E8%A3%9D%E8%88%87-workspace-%E5%85%B1%E7%94%A8">11.4 Project-local 安裝與 Workspace 共用</a></li> <li><a href="#115-agent-mode-%E4%B8%8B%E7%9A%84%E8%A1%8C%E7%82%BA">11.5 Agent Mode 下的行為</a></li> <li><a href="#116-mcp-%E6%BE%84%E6%B8%85%E5%BB%B6%E7%BA%8C-112-%E7%AF%80">11.6 MCP 澄清（延續 1.12 節）</a></li> <li><a href="#117-%E5%88%86%E4%BA%AB%E5%B7%B2%E7%94%9F%E6%88%90%E7%9A%84-skill">11.7 分享已生成的 Skill</a></li> <li><a href="#118-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">11.8 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC12%E7%AB%A0-%E5%85%B6%E4%BB%96-agent-cli-%E6%95%B4%E5%90%88ampcodex-cligemini-clicursorwindsurfcline-%E7%AD%89">第12章 其他 Agent CLI 整合（Amp／Codex CLI／Gemini CLI／Cursor／Windsurf／Cline 等）</a> <ul> <li><a href="#121-%E5%AE%98%E6%96%B9%E6%98%8E%E7%A2%BA%E6%94%AF%E6%8F%B4amp">12.1 官方明確支援：Amp</a></li> <li><a href="#122-agent-skills-%E9%96%8B%E6%94%BE%E6%A8%99%E6%BA%96%E7%9A%84%E5%AE%98%E6%96%B9%E6%8E%A1%E7%94%A8%E8%80%85%E5%90%8D%E5%96%AE2026-08-04-%E6%9F%A5%E8%AD%89%E9%9D%9E%E4%BD%9C%E8%80%85%E6%8E%A8%E8%AB%96">12.2 Agent Skills 開放標準的官方採用者名單（2026-08-04 查證，非作者推論）</a></li> <li><a href="#123-agent-skills-%E6%A8%99%E6%BA%96%E7%9A%84%E6%AD%A3%E5%BC%8F%E8%A6%8F%E6%A0%BCskillmd-frontmatter-%E6%AC%84%E4%BD%8D">12.3 Agent Skills 標準的正式規格：<code>SKILL.md</code> frontmatter 欄位</a></li> <li><a href="#124-%E7%82%BA%E4%BB%80%E9%BA%BC%E7%9B%B8%E5%AE%B9%E6%80%A7%E4%BB%8D%E9%9C%80%E8%87%AA%E8%A1%8C%E9%A9%97%E8%AD%89%E6%A9%9F%E5%88%B6%E6%9C%AC%E8%B3%AA%E5%B7%AE%E7%95%B0%E5%B7%B2%E7%AA%84%E5%8C%96%E7%82%BA%E5%B7%A5%E5%85%B7%E5%AF%A6%E4%BD%9C%E7%B4%B0%E7%AF%80%E5%B1%A4%E7%B4%9A">12.4 為什麼相容性仍需自行驗證：機制本質差異（已窄化為工具實作細節層級）</a></li> <li><a href="#125-%E6%89%8B%E5%8B%95%E6%95%B4%E5%90%88%E6%A8%A1%E5%BC%8F%E4%BD%9C%E8%80%85%E5%BB%BA%E8%AD%B0%E9%81%A9%E7%94%A8-windsurfcline-%E7%AD%89%E5%B0%9A%E6%9C%AA%E6%94%AF%E6%8F%B4-agent-skills-%E6%A8%99%E6%BA%96%E7%9A%84%E5%B7%A5%E5%85%B7">12.5 手動整合模式（作者建議，適用 Windsurf／Cline 等尚未支援 Agent Skills 標準的工具）</a></li> <li><a href="#126-agentsmd-%E6%85%A3%E4%BE%8B%E8%88%87-agent-skills-%E6%A8%99%E6%BA%96%E7%9A%84%E5%88%86%E5%B7%A5%E4%BD%9C%E8%80%85%E5%BB%BA%E8%AD%B0">12.6 <code>AGENTS.md</code> 慣例與 Agent Skills 標準的分工（作者建議）</a></li> <li><a href="#127-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">12.7 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC13%E7%AB%A0-mcp-%E6%95%B4%E5%90%88%E7%9A%84%E6%AD%A3%E7%A2%BA%E7%90%86%E8%A7%A3">第13章 MCP 整合的正確理解</a> <ul> <li><a href="#131-%E5%86%8D%E6%AC%A1%E6%98%8E%E7%A2%BA%E6%BE%84%E6%B8%85">13.1 再次明確澄清</a></li> <li><a href="#132-%E7%82%BA%E4%BB%80%E9%BA%BC%E9%80%99%E5%80%8B%E8%AA%A4%E8%A7%A3%E7%89%B9%E5%88%A5%E5%AE%B9%E6%98%93%E7%99%BC%E7%94%9F">13.2 為什麼這個誤解特別容易發生</a></li> <li><a href="#133-%E8%88%87%E5%B8%B8%E8%A6%8B-mcp-server-%E7%9A%84%E5%88%86%E5%B7%A5%E5%BB%BA%E8%AD%B0%E4%BD%9C%E8%80%85%E5%BB%BA%E8%AD%B0">13.3 與常見 MCP Server 的分工建議（作者建議）</a></li> <li><a href="#134-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">13.4 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC14%E7%AB%A0-reverse-engineering-%E5%A0%B4%E6%99%AF%E6%87%89%E7%94%A8%E4%BD%9C%E8%80%85%E5%BB%B6%E4%BC%B8">第14章 Reverse Engineering 場景應用（作者延伸）</a> <ul> <li><a href="#141-%E7%82%BA%E4%BB%80%E9%BA%BC%E9%80%86%E5%90%91%E5%B7%A5%E7%A8%8B%E9%9C%80%E8%A6%81%E7%9F%A5%E8%AD%98%E5%8F%AF%E6%9F%A5%E8%A9%A2%E5%8C%96">14.1 為什麼逆向工程需要「知識可查詢化」</a></li> <li><a href="#142-%E9%81%A9%E7%94%A8%E7%AF%84%E5%9C%8D%E5%AE%98%E6%96%B9%E8%AA%9E%E8%A8%80%E6%A1%86%E6%9E%B6%E6%89%8B%E5%86%8A%E8%80%8C%E9%9D%9E%E5%8E%9F%E5%A7%8B%E7%A2%BC%E6%9C%AC%E8%BA%AB">14.2 適用範圍：官方語言／框架手冊，而非原始碼本身</a></li> <li><a href="#143-%E8%88%87-reverse-skill-%E7%9A%84%E5%88%86%E5%B7%A5%E5%BB%BA%E8%AD%B0%E4%BD%9C%E8%80%85%E5%BB%BA%E8%AD%B0">14.3 與 <code>reverse-skill</code> 的分工建議（作者建議）</a></li> <li><a href="#144-%E6%A1%88%E4%BE%8B%E8%B5%B0%E6%9F%A5powerbuilder-%E8%80%81%E7%B3%BB%E7%B5%B1%E7%B6%AD%E9%81%8B%E7%9F%A5%E8%AD%98%E5%BA%AB">14.4 案例走查：PowerBuilder 老系統維運知識庫</a></li> <li><a href="#145-%E6%9C%80%E4%BD%B3%E5%AF%A6%E5%8B%99">14.5 最佳實務</a></li> <li><a href="#146-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">14.6 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC15%E7%AB%A0-framework-upgrade-%E5%A0%B4%E6%99%AF%E6%87%89%E7%94%A8%E4%BD%9C%E8%80%85%E5%BB%B6%E4%BC%B8">第15章 Framework Upgrade 場景應用（作者延伸）</a> <ul> <li><a href="#151-%E7%82%BA%E4%BB%80%E9%BA%BC%E6%A1%86%E6%9E%B6%E5%8D%87%E7%B4%9A%E7%89%B9%E5%88%A5%E9%81%A9%E5%90%88%E9%80%99%E5%80%8B%E6%A8%A1%E5%BC%8F">15.1 為什麼框架升級特別適合這個模式</a></li> <li><a href="#152-%E5%90%84%E6%A1%86%E6%9E%B6-migration-guide-%E8%BD%89-skill-%E5%B0%8D%E7%85%A7">15.2 各框架 Migration Guide 轉 Skill 對照</a></li> <li><a href="#153-%E6%A1%88%E4%BE%8Bspring-boot-migration-guide--skill--%E5%8D%87%E7%B4%9A%E5%B0%88%E6%A1%88%E6%9F%A5%E8%A9%A2">15.3 案例：Spring Boot Migration Guide → Skill → 升級專案查詢</a></li> <li><a href="#154-%E6%9C%80%E4%BD%B3%E5%AF%A6%E5%8B%99">15.4 最佳實務</a></li> <li><a href="#155-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">15.5 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC16%E7%AB%A0-%E5%A4%A7%E5%9E%8B-web-application-%E7%9F%A5%E8%AD%98%E5%BA%AB%E6%87%89%E7%94%A8">第16章 大型 Web Application 知識庫應用</a> <ul> <li><a href="#161-%E5%AE%98%E6%96%B9%E7%AB%8B%E5%A0%B4%E5%9B%9E%E9%A1%A7beyond-books">16.1 官方立場回顧：「Beyond Books」</a></li> <li><a href="#162-%E6%8A%8A%E6%95%B4%E5%80%8B-docs-%E8%B3%87%E6%96%99%E5%A4%BE%E8%BD%89%E6%88%90-skill">16.2 把整個 <code>docs/</code> 資料夾轉成 Skill</a></li> <li><a href="#163-dddmicroservicesclean-architecturehexagonal-%E5%A0%B4%E6%99%AF%E6%87%89%E7%94%A8%E4%BD%9C%E8%80%85%E5%BB%B6%E4%BC%B8">16.3 DDD／Microservices／Clean Architecture／Hexagonal 場景應用（作者延伸）</a></li> <li><a href="#164-reviewtestingrefactoring-%E5%A0%B4%E6%99%AF%E6%87%89%E7%94%A8%E4%BD%9C%E8%80%85%E5%BB%B6%E4%BC%B8">16.4 Review／Testing／Refactoring 場景應用（作者延伸）</a></li> <li><a href="#165-%E6%9C%80%E4%BD%B3%E5%AF%A6%E5%8B%99">16.5 最佳實務</a></li> <li><a href="#166-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">16.6 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC17%E7%AB%A0-ai-agent-workflow%E6%96%B9%E6%B3%95%E8%AB%96%E6%95%B4%E5%90%88%E4%BD%9C%E8%80%85%E5%BB%B6%E4%BC%B8">第17章 AI Agent Workflow／方法論整合（作者延伸）</a> <ul> <li><a href="#171-book-to-skill-%E5%9C%A8-ai-agent-workflow-%E4%B8%AD%E7%9A%84%E5%AE%9A%E4%BD%8D">17.1 book-to-skill 在 AI Agent Workflow 中的定位</a></li> <li><a href="#172-%E8%88%87-spec-driven-development-%E7%B3%BB%E5%88%97%E6%96%B9%E6%B3%95%E8%AB%96%E6%95%B4%E5%90%88%E4%BD%9C%E8%80%85%E5%BB%BA%E8%AD%B0">17.2 與 Spec Driven Development 系列方法論整合（作者建議）</a></li> <li><a href="#173-%E8%88%87-multi-agentcouncil-%E9%A1%9E%E6%96%B9%E6%B3%95%E8%AB%96%E6%95%B4%E5%90%88%E4%BD%9C%E8%80%85%E5%BB%BA%E8%AD%B0">17.3 與 Multi-Agent／Council 類方法論整合（作者建議）</a></li> <li><a href="#174-%E6%9C%80%E4%BD%B3%E5%AF%A6%E5%8B%99">17.4 最佳實務</a></li> <li><a href="#175-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">17.5 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC18%E7%AB%A0-%E4%BC%81%E6%A5%AD%E5%B0%8E%E5%85%A5%E6%B2%BB%E7%90%86governance">第18章 企業導入治理（Governance）</a> <ul> <li><a href="#181-governance-%E7%B8%BD%E8%A6%BD">18.1 Governance 總覽</a></li> <li><a href="#182-%E7%89%88%E6%9C%AC%E7%AE%A1%E7%90%86version">18.2 版本管理（Version）</a></li> <li><a href="#183-knowledge-baserepository-%E5%AD%98%E6%94%BE%E7%AD%96%E7%95%A5">18.3 Knowledge Base／Repository 存放策略</a></li> <li><a href="#184-reviewvalidate_skillpy-%E6%B7%B1%E5%BA%A6%E7%94%A8%E6%B3%95">18.4 Review：<code>validate_skill.py</code> 深度用法</a></li> <li><a href="#185-securityscan_generated_skillpy-%E7%9A%84%E6%B2%BB%E7%90%86%E8%A7%92%E8%89%B2">18.5 Security：<code>scan_generated_skill.py</code> 的治理角色</a></li> <li><a href="#186-compliance%E5%90%88%E8%A6%8F">18.6 Compliance（合規）</a></li> <li><a href="#187-audit%E7%A8%BD%E6%A0%B8%E8%BB%8C%E8%B7%A1%E4%BD%9C%E8%80%85%E5%BB%BA%E8%AD%B0">18.7 Audit（稽核軌跡，作者建議）</a></li> <li><a href="#188-rbac%E8%AA%A0%E5%AF%A6%E8%AA%AA%E6%98%8E%E7%84%A1%E5%85%A7%E5%BB%BA%E6%A9%9F%E5%88%B6%E9%9C%80%E4%BE%9D%E8%B3%B4%E5%BA%95%E5%B1%A4%E5%AD%98%E5%8F%96%E6%8E%A7%E5%88%B6">18.8 RBAC（誠實說明：無內建機制，需依賴底層存取控制）</a></li> <li><a href="#189-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">18.9 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC19%E7%AB%A0-cicd-%E6%95%B4%E5%90%88">第19章 CI/CD 整合</a> <ul> <li><a href="#191-book-to-skill-%E8%87%AA%E8%BA%AB%E7%9A%84-ci%E7%9C%9F%E5%AF%A6%E4%BE%9D%E6%93%9A">19.1 book-to-skill 自身的 CI（真實依據）</a></li> <li><a href="#192-%E4%BC%81%E6%A5%AD-ci-%E4%B8%AD%E7%9A%84%E5%93%81%E8%B3%AA%E9%96%98%E9%96%80%E4%BD%9C%E8%80%85%E5%BB%BA%E8%AD%B0">19.2 企業 CI 中的品質閘門（作者建議）</a></li> <li><a href="#193-github-actions-%E5%AE%8C%E6%95%B4%E7%AF%84%E4%BE%8B">19.3 GitHub Actions 完整範例</a></li> <li><a href="#194-gitlab-ci-%E7%AF%84%E4%BE%8B">19.4 GitLab CI 範例</a></li> <li><a href="#195-azure-devops-%E7%AF%84%E4%BE%8B">19.5 Azure DevOps 範例</a></li> <li><a href="#196-jenkins-%E7%AF%84%E4%BE%8B">19.6 Jenkins 範例</a></li> <li><a href="#197-%E8%87%AA%E5%8B%95%E5%BB%BA%E7%AB%8B-skills%E7%9A%84%E5%AF%A6%E9%9A%9B%E5%8F%AF%E8%A1%8C%E9%82%8A%E7%95%8C%E8%AA%A0%E5%AF%A6%E8%AA%AA%E6%98%8E">19.7 「自動建立 Skills」的實際可行邊界（誠實說明）</a></li> <li><a href="#198-%E7%89%88%E6%9C%AC%E7%AE%A1%E7%90%86%E6%B8%AC%E8%A9%A6%E7%99%BC%E4%BD%88">19.8 版本管理／測試／發佈</a></li> <li><a href="#199-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">19.9 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC20%E7%AB%A0-maintenance%E7%B6%AD%E9%81%8B">第20章 Maintenance（維運）</a> <ul> <li><a href="#201-updatefold-in-%E7%B6%AD%E9%81%8B%E9%80%B1%E6%9C%9F">20.1 Update／Fold-in 維運週期</a></li> <li><a href="#202-book-to-skill-%E6%9C%AC%E8%BA%AB%E7%9A%84%E5%8D%87%E7%B4%9A">20.2 book-to-skill 本身的升級</a></li> <li><a href="#203-backup%E5%82%99%E4%BB%BD">20.3 Backup（備份）</a></li> <li><a href="#204-migration%E6%90%AC%E9%81%B7">20.4 Migration（搬遷）</a></li> <li><a href="#205-troubleshooting">20.5 Troubleshooting</a></li> <li><a href="#206-monitoringlogging%E5%BB%B6%E7%BA%8C-310-%E7%AF%80%E7%9A%84%E8%A3%9C%E5%BC%B7%E5%BB%BA%E8%AD%B0">20.6 Monitoring／Logging（延續 3.10 節的補強建議）</a></li> <li><a href="#207-performanceoptimization">20.7 Performance／Optimization</a></li> <li><a href="#208-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">20.8 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC21%E7%AB%A0-%E4%BC%81%E6%A5%AD%E6%9C%80%E4%BD%B3%E5%AF%A6%E5%8B%99best-practice">第21章 企業最佳實務（Best Practice）</a> <ul> <li><a href="#211-%E5%A4%A7%E5%9E%8B%E4%BC%81%E6%A5%AD%E5%A6%82%E4%BD%95%E4%BD%BF%E7%94%A8-book-to-skill%E7%B8%BD%E8%A6%BD">21.1 大型企業如何使用 book-to-skill：總覽</a></li> <li><a href="#212-%E7%9F%A5%E8%AD%98%E6%B2%BB%E7%90%86">21.2 知識治理</a></li> <li><a href="#213-%E6%96%87%E4%BB%B6%E7%AE%A1%E7%90%86">21.3 文件管理</a></li> <li><a href="#214-%E7%89%88%E6%9C%AC%E7%AE%A1%E7%90%86%E6%B2%BB%E7%90%86%E5%8E%9F%E5%89%87%E5%B7%A5%E5%85%B7%E6%93%8D%E4%BD%9C%E8%A6%8B198%E7%AF%80">21.4 版本管理（治理原則，工具操作見19.8節）</a></li> <li><a href="#215-%E5%A4%9A%E4%BA%BA%E5%8D%94%E4%BD%9C">21.5 多人協作</a></li> <li><a href="#216-skill-review%E9%A1%9E%E4%BC%BC-code-review-%E7%9A%84%E5%AF%A9%E6%9F%A5%E6%B5%81%E7%A8%8B">21.6 Skill Review（類似 Code Review 的審查流程）</a></li> <li><a href="#217-quality-gate">21.7 Quality Gate</a></li> <li><a href="#218-ai-governance">21.8 AI Governance</a></li> <li><a href="#219-%E9%81%BF%E5%85%8D%E7%9F%A5%E8%AD%98%E5%A2%B3%E5%A0%B4">21.9 避免「知識墳場」</a></li> <li><a href="#2110-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">21.10 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC22%E7%AB%A0-%E8%88%87%E5%85%B6%E4%BB%96%E5%B7%A5%E5%85%B7%E6%AF%94%E8%BC%83">第22章 與其他工具比較</a> <ul> <li><a href="#221-%E6%AF%94%E8%BC%83%E7%B6%AD%E5%BA%A6%E8%AA%AA%E6%98%8E">22.1 比較維度說明</a></li> <li><a href="#222-vs-notebooklm">22.2 vs. NotebookLM</a></li> <li><a href="#223-vs-%E5%82%B3%E7%B5%B1-rag%E5%B1%95%E9%96%8B-110-%E7%AF%80">22.3 vs. 傳統 RAG（展開 1.10 節）</a></li> <li><a href="#224-vs-mcp-memory-%E9%A1%9E%E4%BC%BA%E6%9C%8D%E5%99%A8">22.4 vs. MCP Memory 類伺服器</a></li> <li><a href="#225-vs-context7">22.5 vs. Context7</a></li> <li><a href="#226-vs-cognee">22.6 vs. Cognee</a></li> <li><a href="#227-vs-codebase-memory-mcp">22.7 vs. codebase-memory-mcp</a></li> <li><a href="#228-vs-openmemory%EF%B8%8F-%E4%BD%9C%E8%80%85%E4%BE%9D%E5%85%AC%E9%96%8B%E8%B3%87%E8%A8%8A%E4%B9%8B%E4%B8%80%E8%88%AC%E6%80%A7%E6%8F%8F%E8%BF%B0%E9%9D%9E%E9%80%90%E4%B8%80%E6%9F%A5%E8%AD%89%E7%89%88%E6%9C%AC%E7%B4%B0%E7%AF%80">22.8 vs. OpenMemory（⚠️ 作者依公開資訊之一般性描述，非逐一查證版本細節）</a></li> <li><a href="#229-vs-knowledge-graph%E9%80%9A%E7%94%A8%E9%A1%9E">22.9 vs. Knowledge Graph（通用類）</a></li> <li><a href="#2210-%E7%B6%9C%E5%90%88%E6%AF%94%E8%BC%83%E8%A1%A8">22.10 綜合比較表</a></li> <li><a href="#2211-%E9%97%9C%E9%8D%B5%E6%B4%9E%E5%AF%9Fbook-to-skill-%E7%9A%84%E5%B7%AE%E7%95%B0%E5%8C%96%E5%AE%9A%E4%BD%8D">22.11 關鍵洞察：book-to-skill 的差異化定位</a></li> <li><a href="#2212-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">22.12 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC23%E7%AB%A0-%E5%AE%8C%E6%95%B4%E6%A1%88%E4%BE%8B%E4%BD%9C%E8%80%85%E5%8E%9F%E5%89%B5%E6%A1%88%E4%BE%8B%E8%B5%B0%E6%9F%A5">第23章 完整案例（作者原創案例走查）</a> <ul> <li><a href="#231-%E6%A1%88%E4%BE%8B%E4%B8%80%E4%BF%9D%E9%9A%AA%E6%A5%AD-spring-boot-34-%E5%8D%87%E7%B4%9A%E7%9F%A5%E8%AD%98%E5%BA%AB%E5%BB%BA%E7%BD%AE">23.1 案例一：保險業 Spring Boot 3→4 升級知識庫建置</a> <ul> <li><a href="#2311-%E8%83%8C%E6%99%AF%E8%88%87%E4%BB%BB%E5%8B%99%E7%99%BC%E8%B5%B7">23.1.1 背景與任務發起</a></li> <li><a href="#2312-%E8%BD%89%E6%8F%9B%E8%88%87%E6%9F%A5%E8%A9%A2%E9%81%8E%E7%A8%8B">23.1.2 轉換與查詢過程</a></li> <li><a href="#2313-%E6%95%88%E7%9B%8A%E8%88%87%E7%9F%A5%E8%AD%98%E6%B2%89%E6%BE%B1">23.1.3 效益與知識沉澱</a></li> </ul> </li> <li><a href="#232-%E6%A1%88%E4%BE%8B%E4%BA%8C%E8%A3%BD%E9%80%A0%E6%A5%AD-legacy-java-%E7%B3%BB%E7%B5%B1%E7%8F%BE%E4%BB%A3%E5%8C%96%E5%89%8D%E7%9A%84%E7%9F%A5%E8%AD%98%E5%BA%AB%E7%9B%A4%E9%BB%9E">23.2 案例二：製造業 Legacy Java 系統現代化前的知識庫盤點</a> <ul> <li><a href="#2321-%E8%83%8C%E6%99%AF%E8%88%87%E4%BB%BB%E5%8B%99%E7%99%BC%E8%B5%B7">23.2.1 背景與任務發起</a></li> <li><a href="#2322-%E8%BD%89%E6%8F%9B%E8%88%87%E6%9F%A5%E8%A9%A2%E9%81%8E%E7%A8%8B">23.2.2 轉換與查詢過程</a></li> <li><a href="#2323-%E6%96%B0%E4%BA%BA-onboarding-%E5%B0%8D%E7%85%A7">23.2.3 新人 Onboarding 對照</a></li> <li><a href="#2324-%E7%9F%A5%E8%AD%98%E6%B2%89%E6%BE%B1%E7%AF%84%E6%9C%AC%E5%9C%98%E9%9A%8A%E5%85%A7%E9%83%A8%E8%A8%98%E9%8C%84%E6%A0%BC%E5%BC%8F%E7%A4%BA%E6%84%8F">23.2.4 知識沉澱範本（團隊內部記錄格式示意）</a></li> </ul> </li> <li><a href="#233-%E6%A1%88%E4%BE%8B%E4%B8%89%E6%96%B0%E5%89%B5%E5%85%AC%E5%8F%B8-vue3-%E5%89%8D%E7%AB%AF%E8%A8%AD%E8%A8%88%E7%B3%BB%E7%B5%B1%E7%9F%A5%E8%AD%98%E5%BA%AB">23.3 案例三：新創公司 Vue3 前端設計系統知識庫</a> <ul> <li><a href="#2331-%E8%83%8C%E6%99%AF%E8%88%87%E4%BB%BB%E5%8B%99%E7%99%BC%E8%B5%B7">23.3.1 背景與任務發起</a></li> <li><a href="#2332-%E8%BD%89%E6%8F%9B%E8%88%87%E6%9F%A5%E8%A9%A2%E9%81%8E%E7%A8%8B">23.3.2 轉換與查詢過程</a></li> <li><a href="#2333-%E6%95%88%E7%9B%8A">23.3.3 效益</a></li> </ul> </li> <li><a href="#234-%E6%A1%88%E4%BE%8B%E5%9B%9Bsi-%E9%A1%A7%E5%95%8F%E5%9C%98%E9%9A%8A%E7%82%BA%E5%AE%A2%E6%88%B6-powerbuilder-%E8%80%81%E7%B3%BB%E7%B5%B1%E5%81%9A%E7%9F%A5%E8%AD%98%E7%A7%BB%E8%BD%89">23.4 案例四：SI 顧問團隊為客戶 PowerBuilder 老系統做知識移轉</a> <ul> <li><a href="#2341-%E8%83%8C%E6%99%AF%E8%88%87%E4%BB%BB%E5%8B%99%E7%99%BC%E8%B5%B7">23.4.1 背景與任務發起</a></li> <li><a href="#2342-%E8%BD%89%E6%8F%9B%E8%88%87%E6%9F%A5%E8%A9%A2%E9%81%8E%E7%A8%8B">23.4.2 轉換與查詢過程</a></li> <li><a href="#2343-%E4%BA%A4%E6%8E%A5%E6%95%88%E7%9B%8A">23.4.3 交接效益</a></li> </ul> </li> <li><a href="#235-%E5%9B%9B%E6%A1%88%E4%BE%8B%E7%B6%9C%E5%90%88%E5%B0%8D%E7%85%A7">23.5 四案例綜合對照</a></li> <li><a href="#236-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">23.6 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC24%E7%AB%A0-%E5%AE%8C%E6%95%B4-cli-%E6%8C%87%E4%BB%A4%E5%A4%A7%E5%85%A8">第24章 完整 CLI 指令大全</a> <ul> <li><a href="#241-%E4%B8%89%E5%B1%A4-cli-%E5%85%A5%E5%8F%A3%E7%B8%BD%E8%A6%BD">24.1 三層 CLI 入口總覽</a></li> <li><a href="#242-pip-%E7%8D%A8%E7%AB%8B-clibook-to-skill">24.2 pip 獨立 CLI：<code>book-to-skill</code></a></li> <li><a href="#243-scriptsextractpyagent-skill-%E5%85%A7%E9%83%A8%E8%96%84%E6%AE%BC%E5%B1%A4">24.3 <code>scripts/extract.py</code>（Agent Skill 內部薄殼層）</a></li> <li><a href="#244-toolsdiscovery_taxpytoken-%E6%88%90%E6%9C%AC%E9%87%8F%E6%B8%AC%E5%B7%A5%E5%85%B7">24.4 <code>tools/discovery_tax.py</code>：Token 成本量測工具</a></li> <li><a href="#245-toolsvalidate_skillpy%E6%A0%BC%E5%BC%8F%E5%90%88%E8%A6%8F%E9%A9%97%E8%AD%89">24.5 <code>tools/validate_skill.py</code>：格式合規驗證</a></li> <li><a href="#246-toolsscan_generated_skillpy%E5%AE%89%E5%85%A8%E6%8E%83%E6%8F%8F">24.6 <code>tools/scan_generated_skill.py</code>：安全掃描</a></li> <li><a href="#247-agent-skill-%E6%96%9C%E7%B7%9A%E6%8C%87%E4%BB%A4book-to-skill%E5%90%84-host-%E5%85%A7%E4%BD%BF%E7%94%A8">24.7 Agent Skill 斜線指令：<code>/book-to-skill</code>（各 Host 內使用）</a></li> <li><a href="#248-cli-cheat-sheet-%E7%B8%BD%E8%A1%A8">24.8 CLI Cheat Sheet 總表</a></li> <li><a href="#249-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">24.9 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC25%E7%AB%A0-faq">第25章 FAQ</a> <ul> <li><a href="#251-%E5%9F%BA%E7%A4%8E%E6%A6%82%E5%BF%B5q1q15">25.1 基礎概念（Q1–Q15）</a></li> <li><a href="#252-%E5%AE%89%E8%A3%9D%E8%88%87%E7%92%B0%E5%A2%83q16q30">25.2 安裝與環境（Q16–Q30）</a></li> <li><a href="#253-%E4%BD%BF%E7%94%A8%E8%88%87%E6%93%8D%E4%BD%9Cq31q48">25.3 使用與操作（Q31–Q48）</a></li> <li><a href="#254-%E6%A0%BC%E5%BC%8F%E8%88%87%E8%A7%A3%E6%9E%90q49q60">25.4 格式與解析（Q49–Q60）</a></li> <li><a href="#255-%E5%AE%89%E5%85%A8%E8%88%87%E5%90%88%E8%A6%8Fq61q72">25.5 安全與合規（Q61–Q72）</a></li> <li><a href="#256-%E4%BC%81%E6%A5%AD%E5%B0%8E%E5%85%A5%E8%88%87%E6%B2%BB%E7%90%86q73q88">25.6 企業導入與治理（Q73–Q88）</a></li> <li><a href="#257-%E8%88%87%E5%85%B6%E4%BB%96%E5%B7%A5%E5%85%B7%E6%AF%94%E8%BC%83q89q98">25.7 與其他工具比較（Q89–Q98）</a></li> <li><a href="#258-%E7%96%91%E9%9B%A3%E6%8E%92%E8%A7%A3q99q112">25.8 疑難排解（Q99–Q112）</a></li> <li><a href="#259-%E6%9C%AC%E7%AB%A0-checklist">25.9 本章 Checklist</a></li> </ul> </li> <li><a href="#%E7%AC%AC26%E7%AB%A0-%E5%B8%B8%E8%A6%8B%E9%8C%AF%E8%AA%A455%E5%80%8B">第26章 常見錯誤（55個）</a> <ul> <li><a href="#261-%E5%AE%89%E8%A3%9D%E8%88%87%E7%92%B0%E5%A2%83%E9%A1%9E%E9%8C%AF%E8%AA%A4-18">26.1 安裝與環境類（錯誤 1–8）</a></li> <li><a href="#262-%E8%BD%89%E6%8F%9B%E8%88%87%E7%94%9F%E6%88%90%E9%A1%9E%E9%8C%AF%E8%AA%A4-918">26.2 轉換與生成類（錯誤 9–18）</a></li> <li><a href="#263-%E6%A0%BC%E5%BC%8F%E8%88%87%E8%A7%A3%E6%9E%90%E9%A1%9E%E9%8C%AF%E8%AA%A4-1926">26.3 格式與解析類（錯誤 19–26）</a></li> <li><a href="#264-skill-%E5%93%81%E8%B3%AA%E8%88%87%E5%85%A7%E5%AE%B9%E9%A1%9E%E9%8C%AF%E8%AA%A4-2736">26.4 Skill 品質與內容類（錯誤 27–36）</a></li> <li><a href="#265-%E5%AE%89%E5%85%A8%E8%88%87%E5%90%88%E8%A6%8F%E9%A1%9E%E9%8C%AF%E8%AA%A4-3744">26.5 安全與合規類（錯誤 37–44）</a></li> <li><a href="#266-%E4%BC%81%E6%A5%AD%E5%B0%8E%E5%85%A5%E8%88%87%E6%B2%BB%E7%90%86%E9%A1%9E%E9%8C%AF%E8%AA%A4-4555">26.6 企業導入與治理類（錯誤 45–55）</a></li> <li><a href="#267-%E6%9C%AC%E7%AB%A0-checklist">26.7 本章 Checklist</a></li> </ul> </li> <li><a href="#%E7%AC%AC27%E7%AB%A0-prompt-engineering%E5%A6%82%E4%BD%95%E5%AF%AB%E5%87%BA%E9%AB%98%E5%93%81%E8%B3%AA-skill">第27章 Prompt Engineering：如何寫出高品質 Skill</a> <ul> <li><a href="#271-%E5%A6%82%E4%BD%95%E5%B0%8D-book-to-skill-%E4%B8%8B%E6%8C%87%E4%BB%A4">27.1 如何對 book-to-skill 下指令</a></li> <li><a href="#272-%E5%A6%82%E4%BD%95%E5%BB%BA%E7%AB%8B%E9%AB%98%E5%93%81%E8%B3%AA-skill%E6%8A%8A-quality-rules-%E8%AE%8A%E6%88%90%E5%9C%98%E9%9A%8A%E5%AF%AB%E4%BD%9C%E8%A6%8F%E7%AF%84">27.2 如何建立高品質 Skill：把 Quality Rules 變成團隊寫作規範</a></li> <li><a href="#273-%E5%A6%82%E4%BD%95%E5%BB%BA%E7%AB%8B%E5%A4%A7%E5%9E%8B-knowledge%E5%88%86%E4%B8%BB%E9%A1%8C%E6%95%B4%E4%BD%B5%E7%AD%96%E7%95%A5">27.3 如何建立大型 Knowledge：分主題整併策略</a></li> <li><a href="#274-%E5%A6%82%E4%BD%95%E9%81%BF%E5%85%8D-hallucination%E5%B9%BB%E8%A6%BA">27.4 如何避免 Hallucination（幻覺）</a></li> <li><a href="#275-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">27.5 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC28%E7%AB%A0-%E4%BC%81%E6%A5%AD%E5%B0%8E%E5%85%A5%E5%BB%BA%E8%AD%B0%E4%BE%9D%E7%94%A2%E6%A5%AD">第28章 企業導入建議（依產業）</a> <ul> <li><a href="#281-%E9%8A%80%E8%A1%8C%E6%A5%AD">28.1 銀行業</a></li> <li><a href="#282-%E4%BF%9D%E9%9A%AA%E6%A5%AD">28.2 保險業</a></li> <li><a href="#283-%E6%94%BF%E5%BA%9C%E9%83%A8%E9%96%80">28.3 政府部門</a></li> <li><a href="#284-%E9%86%AB%E7%99%82%E7%94%A2%E6%A5%AD">28.4 醫療產業</a></li> <li><a href="#285-%E8%A3%BD%E9%80%A0%E6%A5%AD">28.5 製造業</a></li> <li><a href="#286-%E5%A4%A7%E5%9E%8B%E7%B3%BB%E7%B5%B1%E6%95%B4%E5%90%88%E5%95%86si">28.6 大型系統整合商（SI）</a></li> <li><a href="#287-saas-%E5%85%AC%E5%8F%B8">28.7 SaaS 公司</a></li> <li><a href="#288-%E6%96%B0%E5%89%B5%E5%85%AC%E5%8F%B8startup">28.8 新創公司（Startup）</a></li> <li><a href="#289-%E5%90%84%E7%94%A2%E6%A5%AD%E5%B0%8E%E5%85%A5%E8%A6%81%E9%BB%9E%E5%B0%8D%E7%85%A7%E8%A1%A8">28.9 各產業導入要點對照表</a></li> <li><a href="#2810-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">28.10 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC29%E7%AB%A0-%E5%AE%8C%E6%95%B4%E5%AF%A6%E6%88%B0%E5%BE%9E%E4%B8%80%E6%9C%AC-pdf-%E5%88%B0%E5%9C%98%E9%9A%8A%E6%97%A5%E5%B8%B8%E9%96%8B%E7%99%BC%E6%B5%81%E7%A8%8B">第29章 完整實戰：從一本 PDF 到團隊日常開發流程</a> <ul> <li><a href="#291-%E5%AE%8C%E6%95%B4%E6%B5%81%E7%A8%8B%E7%B8%BD%E8%A6%BD">29.1 完整流程總覽</a></li> <li><a href="#292-step-1%E5%8F%96%E5%BE%97-pdf-%E4%B8%A6%E5%88%A4%E6%96%B7%E5%85%A7%E5%AE%B9%E9%A1%9E%E5%9E%8B">29.2 Step 1：取得 PDF 並判斷內容類型</a></li> <li><a href="#293-step-2%E5%9F%B7%E8%A1%8C%E8%BD%89%E6%8F%9B">29.3 Step 2：執行轉換</a></li> <li><a href="#294-step-3%E9%A9%97%E8%AD%89%E8%88%87%E4%BA%BA%E5%B7%A5%E6%8A%BD%E6%9F%A5">29.4 Step 3：驗證與人工抽查</a></li> <li><a href="#295-step-4%E7%B4%8D%E5%85%A5%E7%89%88%E6%8E%A7%E8%88%87-ci-gate">29.5 Step 4：納入版控與 CI Gate</a></li> <li><a href="#296-step-5%E7%99%BB%E8%A8%98%E9%80%B2%E5%9C%98%E9%9A%8A-claudemd">29.6 Step 5：登記進團隊 <code>CLAUDE.md</code></a></li> <li><a href="#297-step-6coding-%E9%9A%8E%E6%AE%B5%E6%9F%A5%E8%A9%A2%E8%BC%94%E5%8A%A9%E8%A8%AD%E8%A8%88%E6%B1%BA%E7%AD%96">29.7 Step 6：Coding 階段查詢輔助設計決策</a></li> <li><a href="#298-step-7code-review-%E5%BC%95%E7%94%A8-skill-%E4%BD%9C%E7%82%BA%E5%AF%A9%E6%9F%A5%E4%BE%9D%E6%93%9A">29.8 Step 7：Code Review 引用 Skill 作為審查依據</a></li> <li><a href="#299-step-8testing-%E9%9A%8E%E6%AE%B5%E4%BE%9D-anti-patterns-%E8%A8%AD%E8%A8%88%E6%B8%AC%E8%A9%A6%E6%A1%88%E4%BE%8B">29.9 Step 8：Testing 階段依 Anti-patterns 設計測試案例</a></li> <li><a href="#2910-step-9deploy-%E5%BE%8C%E6%8C%81%E7%BA%8C-fold-in">29.10 Step 9：Deploy 後持續 Fold-in</a></li> <li><a href="#2911-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">29.11 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E7%AC%AC30%E7%AB%A0-%E7%B8%BD%E7%B5%90%E8%88%87%E6%9C%AA%E4%BE%86%E7%99%BC%E5%B1%95">第30章 總結與未來發展</a> <ul> <li><a href="#301-%E5%85%A8%E6%9B%B8%E6%A0%B8%E5%BF%83%E8%A7%80%E9%BB%9E%E5%9B%9E%E9%A1%A7">30.1 全書核心觀點回顧</a></li> <li><a href="#302-%E7%89%88%E6%9C%AC%E6%BC%94%E9%80%B2%E8%84%88%E7%B5%A1%E8%88%87%E5%B1%95%E6%9C%9B">30.2 版本演進脈絡與展望</a></li> <li><a href="#303-ai-agent-%E8%B6%A8%E5%8B%A2%E8%88%87-skill-%E7%94%9F%E6%85%8B%E7%B3%BB">30.3 AI Agent 趨勢與 Skill 生態系</a></li> <li><a href="#304-knowledge-engineering-%E7%9A%84%E6%9C%AA%E4%BE%86">30.4 Knowledge Engineering 的未來</a></li> <li><a href="#305-%E6%9C%80%E4%BD%B3%E5%BB%BA%E8%AD%B0">30.5 最佳建議</a></li> <li><a href="#306-%E5%AD%B8%E7%BF%92%E8%B7%AF%E7%B7%9A%E5%9C%96">30.6 學習路線圖</a></li> <li><a href="#307-%E6%9C%AC%E7%AB%A0-checklist-%E8%88%87%E5%B0%8F%E7%B5%90">30.7 本章 Checklist 與小結</a></li> </ul> </li> <li><a href="#%E9%99%84%E9%8C%84">附錄</a> <ul> <li><a href="#a1-%E5%85%A8%E6%9B%B8%E6%A0%B8%E5%BF%83%E5%8E%9F%E5%89%87%E9%80%9F%E6%9F%A5">A.1 全書核心原則速查</a></li> <li><a href="#a2-%E5%90%8D%E8%A9%9E%E5%B0%8D%E7%85%A7%E8%A1%A8">A.2 名詞對照表</a></li> <li><a href="#a3-references%E5%8F%83%E8%80%83%E8%B3%87%E6%96%99">A.3 References（參考資料）</a></li> <li><a href="#a4-%E6%96%B0%E9%80%B2%E6%88%90%E5%93%A1%E5%BF%AB%E9%80%9F%E4%B8%8A%E6%89%8B-checklist">A.4 新進成員快速上手 Checklist</a></li> </ul> </li> <li><a href="#%E7%B5%90%E8%AA%9E">結語</a></li> </ul> <!-- TOC-AUTO-END --> <hr> <h2 id="圖例與符號說明">圖例與符號說明</h2> <p>本手冊沿用企業教材慣例，以下符號在全書中意義固定：</p>