Write multi-chapter books (technical, tutorial, monograph) / 逐章写书,支持多种风格
write-book
AI 逐章写书,压缩摘要策略突破上下文窗口限制
Claude Code Skill · Content Creation
Features
- 突破上下文窗口限制 — 通过 OUTLINE + BOOK_SUMMARY 压缩摘要策略(约 9KB 开销),支持写作任意长度书籍
- 5 阶段工作流 — Plan → Research → Write → Review → Build,结构化完成从大纲到成书
- 多种写作风格 — O'Reilly 实战派、学术专著、教程系列等,按需切换
- 双格式输出 — mdBook HTML(GitHub Pages 部署)+ Pandoc PDF(CJK 中文排版就绪)
- GitHub 原生 — 每本书一个 repo,Git 版本控制,Actions 自动构建
How It Works
每次写新章节时,只加载 4 个文件而非全书:
| 文件 | 作用 | 大小 |
|---|---|---|
OUTLINE.md | 全局大纲,理解全书结构 | ~2KB |
BOOK_SUMMARY.md | 全书压缩摘要,每章 ≤500 字 | ~5KB |
chapter-xx/refs.md | 当前章参考文献 | ~1KB |
glossary.md | 术语表,保持前后一致 | ~1KB |
这样即使写到第 20 章,AI 依然清楚第 1 章说了什么。
Quick Start
# 安装依赖
cargo install mdbook # or: brew install mdbook
brew install pandoc basictex
brew install gh
# 开始写书
# 在 Claude Code 中输入:
/write-book
Workflow
- Plan — 收集书籍信息 → 生成 OUTLINE.md → 创建 repo 骨架 → 初始提交
- Research — WebSearch + context7 → 每章生成 refs.md 参考文献
- Write — 每次一章,加载压缩摘要 + 参考文献 + 术语表
- Review — 一致性检查、术语校对、交叉引用、润色
- Build — mdBook → HTML | Pandoc → PDF
Book Repo Structure
book-repo/
├── book.toml # mdBook config
├── OUTLINE.md # 全局大纲
├── BOOK_SUMMARY.md # 全书压缩摘要
├── glossary.md # 术语表(中英对照)
├── src/
│ ├── SUMMARY.md # mdBook 目录
│ ├── chapter-01/
│ │ ├── README.md # 章节正文
│ │ └── refs.md # 本章参考文献
│ └── ...
├── assets/images/ # 图片、图表
└── .github/workflows/ # 自动构建
Showcase
"以前写书最头疼的就是上下文断裂,写到第 8 章忘了第 3 章说过什么。write-book 的压缩摘要策略彻底解决了这个问题。" — 张工 · 后端工程师,《AI 编程实战》12 章技术书
"从大纲到完稿只花了 3 个周末,质量不输市面上的技术书。" — 李明 · SRE 团队负责人,O'Reilly 风格 Kubernetes 教程
"学术写作最需要前后一致的术语和引用,BOOK_SUMMARY 机制让 AI 始终记得全书脉络。" — 王薇 · MBA 在读
License
Commercial · by lovstudio
Related Articles
Use Cases
《AI 编程实战》技术书
用 write-book 从零写了一本 12 章的 AI 编程实战教程,mdBook 构建 + GitHub Pages 发布,两周完成初稿。
以前写书最头疼的就是上下文断裂,写到第 8 章忘了第 3 章说过什么。write-book 的压缩摘要策略彻底解决了这个问题。
O'Reilly 风格 Kubernetes 教程
为团队内训写了一本 Kubernetes 入门教程,O'Reilly 实战风格,含代码示例和架构图。
从大纲到完稿只花了 3 个周末,质量不输市面上的技术书。pandoc 导出的 PDF 中文排版也很棒。
MBA 毕业论文专著
用 write-book 整理 MBA 毕业论文为专著格式,包含文献综述、案例分析、数据图表等。
学术写作最需要前后一致的术语和引用,BOOK_SUMMARY 机制让 AI 始终记得全书脉络,省了大量返工。
Python 数据分析入门
面向零基础学员的 Python 数据分析教程,15 章,含习题和项目实战。
write-book 的分章写作 + 自动构建流程太丝滑了,改一章就能自动更新整本书的在线版本。