| name | book-to-okf |
| description | 把长文, 书稿, 讲义或系列文章拆解为符合 OKF v0.1 的知识包(bundle), 按章节, 概念, 人物, 术语建立互链的概念页. 适用场景包括把一本书或长文档转成结构化知识库, 为写作素材建立可检索的概念网络, 把教程系列整理为 OKF. 当用户提到把书或长文转成 OKF, 拆书, 建立读书知识库, 或为书稿建概念库时触发. |
| type | Skill |
| title | Book to OKF |
| lang | zh |
| tags | ["okf","book","写作","skill"] |
| license | MIT |
Book to OKF
把一本书 / 长文 / 讲义,拆成一座互相链接的 OKF 知识库——灵感来自 Karpathy 的 LLM Wiki 里"读书时边读边建 fan-wiki"的例子。
何时使用
- 用户给一份书稿 / 长文 / 系列教程,想要可检索、可问答的概念网络;
- 写作者想为素材建立"实体—概念—主题"互链的第二大脑。
拆解模型(一个概念一个文件)
不要按"一章一文件"粗暴切分。按知识对象建概念:
概念类型(type) | 内容 |
|---|
Chapter | 每章摘要 + 指向其涉及的实体/概念 |
Concept | 一个核心概念/术语的独立页(可被多章引用) |
Entity | 人物、组织、地点、作品等实体页 |
Theme | 跨章节的主题/论点,记录它在哪些地方出现、如何演变 |
Timeline | (适用时)事件时间线 |
工作流
- 先扫一遍全书,列出概念清单(章节 + 反复出现的实体/术语/主题)。先列再写。
- 用
../okf-creator/scripts/scaffold_okf.py 起骨架(目录建议 chapters/、concepts/、entities/、themes/)。
- 逐章 ingest(借鉴 Karpathy 的三操作):
- 写
Chapter 摘要页;
- 更新相关
Concept/Entity 页(同一个人物在多章出现 → 持续补充同一页,而非每章新建);
- 在
themes/ 记录主题演变;
- 往根
log.md 追加 ## YYYY-MM-DD 一条。
- 建交叉链接:概念间用包内绝对链接互连,形成图谱(人物↔事件↔主题)。
- lint:找孤儿页、被提及却没建页的概念、矛盾点。
- 校验:
validate_okf.py。
- (可选)用
okf-to-book 把知识库反向发布成可浏览的文档站/图谱。
原则
- 复用而非重复:同一概念只一页,各处链接它;
- 正文要执行洞察:摘要不是目录复述,要写出"这章到底说了什么、和别处怎么连";
- 保留出处:每个概念页用
# Citations 标注书中位置(章节/页码),resource 可指原文件。
多语言
中英双语书可用 i18n 约定:lang + canonical(见 规范译文末)。
