前言¶

紙質書或 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）