write-book — 逐章写书，突破上下文窗口限制

以 GitHub repo 为单一数据源，逐章写作完整书籍。通过「全书压缩摘要 + 当前章全文」策略解决上下文窗口限制。

When to Use

• 用户想写一本完整的书籍（技术书、教程、专著等）
• 用户提到写书、出书、O'Reilly、技术书
• 用户想把系列内容组织成书

Repo Structure

每本书是一个独立 GitHub repo，结构如下：

book-repo/
├── book.toml              # mdBook config
├── SUMMARY.md             # mdBook TOC (auto-generated from OUTLINE.md)
├── OUTLINE.md             # 全局大纲 — 每次写作会话必须加载
├── BOOK_SUMMARY.md        # 全书压缩摘要 — 每章≤500字，每次写作加载
├── bibliography.md        # 完整参考文献（BibTeX 风格）
├── glossary.md            # 术语表（中英对照）
├── src/                   # mdBook source
│   ├── SUMMARY.md         # mdBook 目录（从 OUTLINE.md 生成）
│   ├── chapter-01/
│   │   ├── README.md      # 章节正文
│   │   ├── section-01.md  # 小节（大章节拆分时用）
│   │   └── refs.md        # 本章参考文献 + 研究笔记
│   ├── chapter-02/
│   │   └── ...
│   ├── appendix-a.md
│   └── references.md      # 全书参考文献
├── references/            # 预置参考文献库
├── assets/images/         # 图片、图表
├── scripts/               # 构建脚本
└── .github/workflows/     # GitHub Actions 自动构建

Workflow

Read references/workflow.md for the complete 5-phase workflow.

Phase summary:

1. Plan — Collect book info → OUTLINE.md → repo skeleton → initial commit
2. Research — WebSearch + context7 → refs.md per chapter
3. Write — One chapter per session, load OUTLINE + BOOK_SUMMARY + refs + glossary
4. Review — Consistency, terms, cross-references, polish
5. Build — mdBook → HTML | Pandoc → PDF (CJK-ready)

Context Window Strategy (MANDATORY)

每次写作新章节时，MUST 加载以下文件：

1. OUTLINE.md — 全局大纲（理解全书结构）
2. BOOK_SUMMARY.md — 全书压缩摘要（理解已写内容）
3. src/chapter-xx/refs.md — 当前章参考文献（如有）
4. glossary.md — 术语表（保持术语一致）

不要加载其他章节全文 — 这是上下文窗口管理的关键。

Writing Style

• 语言：中文正文，代码/术语保留英文原文
• 风格：默认 O'Reilly 实战派（概念 → 代码 → 最佳实践 → 陷阱），可按用户要求调整
• 每章开头用一个实际问题或场景引入
• 每章末尾加 "本章小结" + "延伸阅读"
• 完成后更新 BOOK_SUMMARY.md（≤500 字）+ glossary.md

Dependencies

cargo install mdbook    # or: brew install mdbook
brew install pandoc basictex
brew install gh