前言¶
读一本非虚构书，常见做法是边看边记，或事后凭印象写几句感想。前者耗时，后者容易漏掉结构和论证。若你已经在用 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 。
