前言¶

纸质书或 PDF 随手划线，笔记往往堆在文档里，和章节结构、概念之间的关系脱节。换一本书或隔几周再读，很难快速回到当时的阅读地图。若希望 Agent 不只生成摘要，而是按「先建框架、再摘录、再复盘、最后导出」走完一条可复用的阅读流程，需要一套约定好的数据结构与触发方式。下面介绍 SkillHub 社区 Skill「对话读书」（@user_fd308b11/reading-assistant-skill，当前版本 1.0.3），它把深度阅读拆成章节框架、五维摘录卡片和六大知识结构模块，并通过「读书」等口令驱动全流程。

这是什么¶

「对话读书」是面向知识管理的 Agent Skill，由社区发布者 user_fd308b11 维护，在 SkillHub 分类为 knowledge-management，来源为 community。官方说明将其定位为深度阅读引导系统：框架先行，构建结构化阅读体验；支持五维摘录卡片和六大知识结构模块。触发场景包括：用户输入「读书」记录摘录、查看章节框架、更新概念索引、进行章节复盘或导出知识结构。Skill 元数据标明 requires_api_key=false，不依赖外部 API Key。SkillHub 页面显示评分 100000、下载 1304 次、安装 26 次（统计以页面为准）。

Skill 包内工作流文档版本为 v3.0，书籍档案落在项目下的 ./reading-notes/（含 books/{书名}.json 等），并附带 Python 脚本处理导入、导出、搜索与统计。

核心功能¶

以下能力均来自 Skill 包内 SKILL.md 与参考文档，可按流程理解。

检视阅读：章节框架¶

用户给出书名后，Agent 可创建书籍档案（状态 reading，阶段 inspection），生成章节列表、每章摘要与关键要点，并写入 current.json 等状态。用户可说「查看框架」「章节结构」查看，或通过「调整框架」「修改章节」修改名称或顺序。

诠释阅读：五维摘录卡片¶

以「读书」开头输入原文时，摘录会沿章节框架归位；若章节识别失败会请用户确认。每条摘录扩展为五个维度：原文、标签（约 3–5 个）、深层含义、应用、提问。同时可更新核心概念索引与概念联结。支持「查看摘录」「修改摘录」。

五维与六大模块在数据结构中的对应关系如下（节选）：

• 五维：摘录字段 content、tags、deep_meaning、application、question
• 六大知识结构模块：concept_index（核心概念索引）、concept_connections（概念联结图）、questions（待思考问题）、experiments（关键实验/研究）、cross_chapter_links（跨章联结表）、阅读输出（完成阅读阶段的总结任务）

章节复盘¶

用户说「章节复盘」或「完成本章」时，汇总本章摘录，更新概念联结与跨章联结，整理待思考问题，并可引导进入下一章。

阅读输出与导出¶

用户说「读完了」或「完成阅读」时，可将书籍标为 completed、阶段 output，生成完整知识结构报告，并引导完成阅读输出（如核心观点总结等）。导出可说「导出」或「导出知识结构」，由 scripts/export_notes.py 支持 Markdown、HTML 等格式；模板见包内 assets/export_markdown.md、assets/export_html.html。

导入、搜索与统计¶

• 导入：用户说「导入笔记」，调用 scripts/import_notes.py，兼容 v3.0 结构，可从旧数据生成框架与概念索引（文档说明兼容 v1.0/v2.0）。
• 搜索：用户说「搜索」或「查找」，调用 scripts/search_notes.py，支持关键词、标签、章节、概念筛选。
• 统计：用户说「统计」或「阅读报告」，调用 scripts/stats.py，支持单书与全局汇总。

辅助脚本还包括 scripts/chapter_parser.py（章节识别）。Python 依赖在 Skill 元数据中声明：python-dateutil==2.8.2。

安装与启用¶

方式一：SkillHub CLI（推荐）¶

先确认本机已安装 skillhub：

command -v skillhub && skillhub --version

未安装时，可按 SkillHub 安装文档执行（完整安装示例）：

curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

安装 Skill 时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别。对话读书的安装坐标与命令为：

skillhub install reading-assistant-skill --namespace user_fd308b11 --dir <你的 skills 目录>

常见路径（来自 SkillHub 安装文档）：

• Cursor：~/.cursor/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/
• Claude Code：~/.claude/skills/

安装后按所用客户端要求刷新或重启 Agent，使 Skill 被加载。

方式二：让 Agent 按文档安装¶

SkillHub 技能页提供的提示等价于：请 Agent 阅读 https://skillhub.cn/install/skillhub.md，并安装 @user_fd308b11/reading-assistant-skill。适合已开启联网、且由 Agent 代为执行 CLI 的场景。

典型用法¶

经过上面的安装，可在对话中按 Skill 约定口令操作。下列示例摘自官方 Skill 文档，便于复现交互节奏（实际章节名与生成内容因书名而异）。

1. 开书并确认框架

用户：读书 论语

Agent 创建档案并展示章节框架，用户确认后即可摘录。

2. 记录一条五维摘录

用户：读书 子曰："学而时习之，不亦说乎？有朋自远方来，不亦乐乎？人不知而不愠，不亦君子乎？"

Agent 归位章节、生成五维卡片并更新概念索引。

3. 章节复盘

用户：章节复盘

Agent 汇总本章摘录、联结与待思考问题。

4. 结束阅读并导出

用户：读完了
用户：导出知识结构

按提示选择 Markdown 或 HTML；导出路径示例为 ./reading-notes/exports/论语-知识结构.md（以运行时书名为准）。

5. 导入旧笔记

用户：导入笔记

或提供文件如「导入论语笔记.txt」，由 import_notes.py 升级数据结构。

适用场景与注意¶

适合谁：需要长期读非虚构或经典文本、希望笔记挂在章节框架与概念索引上的人；习惯用自然语言（「读书 …」「章节复盘」「导出」）驱动 Agent，而不是单独维护多套笔记模板。

使用注意：

• 数据默认写在当前工作目录的 ./reading-notes/，删除等敏感操作需用户确认，文档建议定期备份。
• 交互原则强调「框架先行」：先确认章节框架再大量摘录，五维字段尽量完整，知识结构随摘录自动维护。
• Skill 文档推荐优先使用公版书目以降低版权风险，并列举了《论语》《红楼梦》《理想国》等示例书名；读有版权的在售书时，摘录内容仍应由用户自行把握授权与合规。
• 导出、搜索、统计依赖包内 Python 脚本，运行环境需能执行 Python 并满足 python-dateutil 依赖。

结尾¶

「对话读书」把深度阅读拆成框架、五维卡片、六大知识模块和导入导出脚本，用统一口令在 Agent 里走完检视、诠释、复盘与输出。若你在 SkillHub 上查找知识管理类阅读辅助，可从官方技能页与 API 坐标入手：

• SkillHub：https://www.skillhub.cn/skills/user_fd308b11/reading-assistant-skill
• 坐标：@user_fd308b11/reading-assistant-skill（v1.0.3，community / knowledge-management）