book-skill

book — 从零生成一本带设计感的 PDF 书

An agent skill that turns a topic into a fully-designed, print-ready PDF book — researched outline, per-chapter writing, cover, table of contents, per-chapter illustrations, polished typesetting, and a fact-check pass. Works with any coding-agent environment (Claude Code, Codex, …).

把一个主题，经「广泛调研定目录 → 逐章并行写作 → 配封面与插画 → Typst 精排 → 事实核查与统稿」，做成一本封面、目录、插画、排版俱全、可直接出片的 PDF 书。

这是一个 agent skill：把它放进你的编码 agent 的 skills 目录，对它说「用 book skill 写一本《XX》」即可。它与具体工具无关——Claude Code、Codex 等都能用（用谁的子代理/并行机制都行，不支持并行就顺序做）。

效果示例 / Examples

以下为用本 skill 生成的一本示例书的真实页面。

每章一张彩色手绘信息图（手账 / sketchnote 风，纯白底，中文标签准确，各章不同）：

排版正文页（横版、双栏正文、跨页嵌入彩色信息图）：

它能产出什么

• 📕 封面：整版主色 + 衬线大标题（或调外部封面 skill 做精美封面）
• 📑 自动目录：从章节标题自动抓「标题 … 页码」
• 🎨 每章一张主题插画：白底、手绘、彩色 sketchnote 信息图（冰山 / 登山岔路 / 通关闸门 …），中文标签准确、各章不同
• 📐 统一精排：横版、衬线标题 + 无衬线正文、双栏正文、跨页代码/表/流程图
• ✅ 事实核查 + 统稿：联网核实数字/版本/API、校验交叉引用、术语统一、外科手术式就地修正

工作流（6 阶段）

0 立项   → 和你对齐主题/读者/风格/是否插画
1 调研   → 多路并行调研一手来源 → 合成结构化目录(TOC)，给你过目
2 写章   → 每章一个子任务：写 Typst 正文 + 自编译自修复到零错误
3 配图   → 章节扉页走极简线条插画；封面/精美图走升级路径
4 拼装   → build_book.py 拼出 book.typ → typst 编译 → 逐页抽查
5 核查   → 事实核查 + 统稿，多轮重编

详见 references/pipeline.md。

内文图三条路（都嵌成 #diagram("name")）

详见 references/diagrams.md、styles/<style>/infographic-prompt.md。

安装

# 1) 放进你的 agent 的 skills 目录（Claude Code 为例）
git clone https://github.com/songhuichen7-jpg/book_skill ~/.claude/skills/book
# Codex 可放到 ~/.codex/skills/book

# 2) （可选，仅用 Mermaid 功能图时）装 mermaid-cli
cd ~/.claude/skills/book/tools && npm install @mermaid-js/mermaid-cli

然后在 agent 里：「用 book skill 写一本《主题》」。

依赖

• typst — 排版编译（必需）。brew install typst
• 图像生成能力 — 章节插画/封面用。skill 默认调 codex CLI（codex exec），也可换任意可用的图像生成 CLI/能力
• mmdc（mermaid-cli，可选）— 仅当用 Mermaid 功能图时；cd tools && npm install（会带一个 chromium）
• 字体 — anthropic 风格默认用常见系统衬线/无衬线字体；缺字就在 styles/anthropic/template.typ 顶部换等价字体

目录结构

book/
├── SKILL.md                 # 入口：何时用、流程速查、配图决策
├── references/
│   ├── pipeline.md          # 6 阶段流水线（主干，必读）
│   ├── template-api.md      # 每章正文的写作契约 + 可用组件
│   ├── illustrations.md     # 扉页插画：生图 → 色键抠透明
│   └── diagrams.md          # 内文图三条路（flow / Mermaid / 插画信息图）
├── scripts/
│   ├── build_book.py        # 从 toc.json 拼出 book.typ
│   ├── gen_illustrations.py # 逐章生图 + 抠透明（扉页线条插画）
│   ├── gen_infographics.py  # 逐张生成彩色插画信息图（自动漂白底 + 失败重试）
│   ├── render_mermaid.py    # Mermaid → PNG
│   └── chroma_key.py        # 色键抠透明工具
├── styles/
│   ├── README.md            # 风格契约 + 如何加新风格
│   └── anthropic/           # 内置风格：暖纸纯白 + 单一赤陶橙 + 衬线/无衬线
│       ├── template.typ     # 风格契约的 Typst 实现（导出全部组件）
│       ├── style.md
│       ├── illustration-prompt.md   # 扉页线条插画 art-direction
│       ├── infographic-prompt.md    # 彩色插画信息图 art-direction
│       ├── mermaid-template.mmd / mermaid.css
└── tools/                   # mermaid-cli（不入库，自行 npm install）

可插拔风格

每本书选一个风格（styles/<name>/），决定全部视觉与排版口味。内置 anthropic。加新风格只需照 styles/README.md 的组件契约新建一套 template.typ + style.md + illustration-prompt.md，正文/流水线/脚本一字不用改。

设计取舍 / 经验（写进了各 reference）

• 诚实：内容是「调研 + 模型知识」生成，付印前请人工通读；事实尽量带一手来源；闭源系统内部细节用「据社区逆向/分析」措辞。
• 图的两个坑：① 生图模型常给近白底，挨着白页显灰 → 脚本内置 whiten() 强制纯白；② 复杂长 prompt 会让生图超时/不出图 → prompt 精简 + 失败自动重试 + 只取本次新增图。
• 手绘要主动逼出彩色：手账涂鸦默认偏黑白，风格前缀里要明确「彩色平涂、每张 ≥4 色、不同分区不同色」。

致谢

• 排版 Typst、图表 mermaid-cli。
• 插画风格为本 skill 原创（手绘彩色 sketchnote + 自有调色板），创作时浏览过社区里的手绘插画 skill 以理解「有趣」的方向，但风格、配色与实现均自成一套。

License

MIT