前言¶
整本书的系统阅读，常见做法是人工做读书笔记、按章节摘抄，再单独整理概念表和引用。这类流程能控质量，但耗时长，且一旦需要回查原文，往往要在 PDF 里反复翻页。若交给通用对话模型做「全书总结」，又容易缺少可核对的页码与摘选，学术场景下引用可信度不足。
下面介绍 SkillHub 上的社区技能「深度拆书」（v1.3.0）：面向 PDF 书籍，按技能说明生成从宏观到微观的多层拆书报告，并对重要观点标注页码与原文摘选；找不到原句时须标注 [未找到原句/页码缺失]，禁止伪造引用。
这是什么¶
「深度拆书」是全自动化深度学术拆书助手，坐标为 @user_8b175ecd/bookbreakdown，由社区发布者 user_8b175ecd 维护，分类为 knowledge-management。在 SkillHub 页面当前显示版本 1.3.0，标签标明 requires_api_key=false（安装使用该技能本身不依赖额外 API Key 配置）。
技能定位是：用户上传 PDF，由 Agent 按 SKILL.md 工作流输出全维度拆书报告，覆盖整体结构、作者论点、学术对话、理论与实践等层面，并附带可回查的摘选索引。
核心功能¶
以下能力均来自 SkillHub 官方简介，未在页面单独展开的实现细节不作延伸。
报告层次与学术向分析¶
- 从宏观整体到微观细节的多层解读。
- 作者观点、学术对话、理论建构与实践应用等维度。
- 研究方法与数据来源提取。
- 核心概念的操作化定义评估。
引用与可核对性¶
- 重要观点配套准确页码与原文摘选。
- 无法定位原句时标注
[未找到原句/页码缺失]，不得编造引用。 - 原文摘选索引：按页码排序，便于回到 PDF 核对。
v1.3 新增与加强项¶
- 段落级微观精读：逐句拆解。
- 证据链分析：逐条列出具体案例名、数据来源、引用文献。
- 概念使用场景分析：书中每次使用该概念时的原句与语境。
三档深度¶
支持 快速 / 标准 / 深度 三档，可按时间与细致程度选择（具体档位差异以技能内 SKILL.md 为准）。
触发场景（技能自述）¶
当用户提交 PDF，并请求拆书、学术解读、书籍分析、章节精读、概念梳理、RIA 拆解，或任何需要对整本书做系统性深度阅读与分析的任务时，应使用该技能。
安装与启用¶
技能包遵循通用 SKILL.md 格式，需安装到当前 Agent 能识别的 skills 目录。SkillHub 官方安装说明指出：使用 skillhub install 时应通过 --dir 指定当前 Agent 的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 文档使用安装脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
亦可使用 npm 全局安装 @astron-team/skillhub，或以 npx @astron-team/skillhub@latest 运行；若默认 registry 不是 SkillHub 国内商店，需按 CLI 文档配置 SKILLHUB_REGISTRY 或 --registry（默认文档示例为 https://skill.xfyun.cn，以你环境中的 CLI 说明为准）。
2、安装「深度拆书」到对应 Agent 目录¶
按你使用的客户端选择目录（摘自 SkillHub 安装文档中的常用路径）：
| Agent | skills 目录（用户级示例） |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/（或项目下 .agents/skills/） |
安装命令示例（将 --dir 换成上表中你实际使用的路径；版本号与坐标以 SkillHub 页面为准）：
skillhub install @user_8b175ecd/bookbreakdown --version 1.3.0 --dir ~/.cursor/skills/
安装后按各 Agent 要求刷新或重启，使新技能被加载。页面亦提供 SkillHub 技能详情入口，可在浏览器中查看说明后再决定是否安装。
典型用法¶
官方简介未给出固定对话模板，可复现的使用方式如下。
- 确认技能已出现在当前 Agent 的 skills 列表中。
- 在对话中上传目标书籍的 PDF 文件（技能输入为 PDF，非纯文本书名）。
- 用自然语言说明任务，并尽量对齐技能自述场景，例如：
- 「请用深度拆书技能，对这份 PDF 做标准档全书拆书，输出带页码的摘选。」
- 「按章节精读第 3 章，并做概念使用场景梳理。」
- 「做 RIA 拆解，并单独给出证据链与研究方法、数据来源提取。」 - 在输出中检查：关键论断是否带页码与摘选；缺失处是否为
[未找到原句/页码缺失]；需要回查时使用按页码排序的摘选索引。
若只需快速把握结构，可明确要求 快速 档；需要段落级精读与证据链时，选择 深度 档。
适用场景与注意¶
适合谁
- 需要系统性读透一本学术或方法论向 PDF，并产出可核对引证笔记的研究者、学生与知识工作者。
- 要把书中概念、案例与文献链条整理成可复查文档，而非一次性摘要的场景。
限制与注意
- 输入为 PDF；扫描版、版式复杂或 OCR 质量差的文件，可能影响页码与摘选准确度，技能已约定无法核对时须显式标注缺失，而非补写原句。
- 三档深度与单次上下文长度会影响耗时与细致程度，长书建议分章节或分卷请求。
- 技能为 community 来源，内容与质量以发布者维护的 SKILL.md 为准；使用前可在 SkillHub 查看评分与下载量（页面当前显示评分 100000、下载 1535，统计会随平台更新变化）。
- 拆书报告不能替代你对原文的最终判断；页码与摘选应作为回查入口，重要结论仍建议在 PDF 中二次确认。
结尾¶
「深度拆书」把 PDF 全书分析、页码级引证和 v1.3 的段落精读、证据链与概念语境梳理收敛到一条 Agent 工作流里，适合需要可核对学术拆书交付物的场景。详情与安装入口见 SkillHub：
- 技能页面：https://www.skillhub.cn/skills/user_8b175ecd/bookbreakdown
- API 坐标页：https://api.skillhub.cn/user_8b175ecd/bookbreakdown
