前言¶
讀一本非虛構書，常見做法是邊看邊記，或事後憑印象寫幾句感想。前者耗時，後者容易漏掉結構和論證。若你已經在用 Obsidian 做知識庫，更希望 Agent 能按固定模板把「內容骨架、核心觀點、金句、實踐路徑」等拆清楚，並直接落到 vault 裏，而不是每次從零寫提示詞。
下面介紹 SkillHub 社區 Skill「拆書」（座標 @user_fe8721be/jmy005，當前版本 1.0.1）。它把「多源檢索書籍信息 → 按模板拆解 → 寫入 Obsidian」串成一條可複用流程；頁面標註 requires_api_key=false，不依賴額外 API Key。
這是什麼¶
「拆書」是社區發佈者 user_fe8721be 在 SkillHub 上架的知識管理類 Skill（分類 knowledge-management，來源 community）。一句話定位：根據用戶提供的書名 + 作者，通過搜索獲取書評、簡介、目錄等信息，再按內置拆書模板生成結構化筆記，並用 Obsidian CLI 寫入 vault 中的「拆書」目錄。
官方入口：
- SkillHub 頁面：https://www.skillhub.cn/skills/user_fe8721be/jmy005
- API 座標頁：https://api.skillhub.cn/user_fe8721be/jmy005
核心功能¶
以下能力均來自該 Skill 的 SKILL.md 說明。
觸發方式
當對話中出現「拆書」「幫我拆書」「書籍拆解」「書評提煉」「瞭解這本書的精華」等意圖時，Agent 應按本 Skill 執行。
檢索與補全
- 用戶輸入書名與作者，示例格式：
巫蠱亂長安 譚木聲。 - Agent 使用
web_fetch按關鍵字書名 作者 書評 內容簡介檢索；Skill 文檔中給出了百度、必應等搜索 URL 示例。 - 策略上先抓書評與簡介，再查目錄與章節；可選補充豆瓣、知乎等來源。
- 僅書名無作者時，先嚐試自動搜作者，搜不到再請用戶補充；結果爲空或過少時，按文檔擴大檢索或提示換詞。
拆書前確認
開始正式拆解前，應向用戶確認：列出已搜到的書名、作者、豆瓣評分等信息，確認無誤後再寫正文。
拆書模板（輸出結構）
核心塊包括：內容骨架（思維導圖式框架）、3–5 個核心觀點、5–8 個關鍵概念（白話解釋）、金句矩陣（歷史類按歷史智慧/人性洞察等維度摘錄）、實踐路徑（三步法：動作、目的、場景）。進階部分含同領域兩本書對比、認知陷阱、精讀/略讀建議、延伸思考題。全文按 PREP（觀點—理由—案例—重申）組織。
寫入 Obsidian
- 確保 vault 下存在「拆書」文件夾（不存在則創建）。
- 以書名爲文件名創建筆記，使用
silent避免自動打開編輯器。
obsidian create path="拆書/書名.md" content="拆書內容" silent overwrite
完成後向用戶返回：文件路徑、核心觀點摘要、建議閱讀方式。
安裝與啓用¶
Skill 基於通用 SKILL.md 格式。在 SkillHub 頁面可通過提示詞讓 AI 安裝，原文爲：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_fe8721be/jmy005`。
若本機已安裝 SkillHub CLI，可先檢查版本，再安裝到當前 Agent 識別的 skills 目錄（安裝時必須帶 --dir，否則默認落在 ./skills/ 且可能不被識別）：
command -v skillhub && skillhub --version
未安裝 CLI 時，可按 SkillHub 安裝文檔執行完整安裝（節選）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本 Skill：
skillhub install @user_fe8721be/jmy005 --dir <你的 Agent skills 目錄>
常見客戶端 skills 路徑（摘自 SkillHub 安裝文檔）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或項目下的.agents/skills/
裝好後按你所用客戶端的規則重啓或刷新 Agent，使 Skill 生效。SkillHub 頁面顯示本包版本爲 v1.0.1；統計信息以頁面爲準（例如下載、安裝次數會隨時間變化）。
典型用法¶
- 在已啓用 Skill 的 Agent 對話中說明意圖，例如：「幫我拆書」。
- 提供書名與作者，格式與文檔一致，例如：
巫蠱亂長安 譚木聲。 - Agent 檢索並展示搜到的書籍信息，等待你確認。
- 確認後生成拆書正文，執行
obsidian create寫入拆書/書名.md。 - 閱讀 Agent 返回的路徑摘要與閱讀建議，在 Obsidian 中打開筆記覈對。
檢索階段在 Skill 文檔中的示例（Agent 側調用，供理解流程）：
web_fetch({'url': 'https://www.baidu.com/s?wd=巫蠱亂長安 譚木聲 書評'})
web_fetch({'url': 'https://www.baidu.com/s?wd=巫蠱亂長安 譚木聲 內容簡介'})
web_fetch({'url': 'https://cn.bing.com/search?q=巫蠱亂長安 譚木聲 目錄'})
適用場景與注意¶
適合誰
- 用 Obsidian 沉澱讀書筆記，希望輸出結構統一（骨架、觀點、金句、行動項）。
- 想先通過檢索快速瞭解一本書的爭議點與目錄，再決定是否精讀。
- 需要在 Agent 裏用自然語言觸發，而不是每次手寫長提示詞。
限制與依賴
- 書籍信息來自公開網頁檢索，質量取決於搜索結果；冷門書、信息少的書可能觸發文檔中的「擴大搜索」或需你補充材料。
- 寫入步驟依賴本機已配置可用的 Obsidian CLI（
obsidian create）；未安裝或未指向正確 vault 時，拆解內容可能只能以對話形式返回。 - Skill 要求拆書前與用戶確認，避免搜錯書；若自動推斷作者失敗，需你補全作者。
- 拆書內容是 Agent 基於檢索材料的歸納，不能替代閱讀原文；涉及史實、數據、引文時仍應以原書爲準。
結尾¶
「拆書」把書名作者輸入、多源檢索、固定拆書模板和 Obsidian 落盤連成一條鏈路，適合把閱讀產出直接納入知識庫。安裝與座標以 SkillHub 爲準：https://www.skillhub.cn/skills/user_fe8721be/jmy005 。
