---
name: huanwangorg-book-pdf
description: |
深度调研一个主题，生成100页+书籍级PDF手册。模块化HTML片段架构 + 语义化版本管理 + 多Agent并行写作 + Playwright渲染PDF。
当用户需要制作完整的PDF手册、电子书、橙皮书、参考指南时触发。即使用户只是说「做一本书」「做个PDF手册」「做个完整指南」「做一本XX的手册」也应触发。
明确触发词：橙皮书、PDF手册、电子书、参考指南、完整手册、书籍级PDF、做一本。
与huanwangorg-md-to-pdf的区别：md-to-pdf转换单个md文件；本skill从零开始（调研→规划→多agent并行写作→合并构建→版本管理）。
---
# Book-PDF：书籍级PDF手册全流程
从一个主题到100页+专业PDF。五个阶段：调研 → 规划 → 写作 → 构建 → 版本更新。
## 前置依赖
- Node.js >= 16
- Playwright：`npm install playwright && npx playwright install chromium`
## 参考资料导航
| 需要时读取 | 文件 | 内容 |
|-----------|------|------|
| 写HTML片段时 | [references/design-system.md](references/design-system.md) | CSS变量、主题、组件HTML速查、视觉红线 |
| 新建项目时 | `templates/` 目录 | 可直接复制的骨架文件（build.js/build-pdf.js/update.sh/styles.css） |
| 参考已有项目时 | `01-公众号写作/_过程文件/openclaw-guide/` | 首个实战项目（8 Part、35节、100页+） |
## 项目初始化
用 init 脚本一键创建项目骨架：
```bash
bash scripts/init-project.sh <项目目录> <手册标题>
# 示例：bash scripts/init-project.sh ./my-guide "Python完全指南"
```
自动创建目录结构、复制模板文件、生成 version.json/CHANGELOG.md/PROJECT.md、检查依赖。
## 项目结构
```
{项目名}/
├── PROJECT.md # 项目中枢（大纲+进度+数据速查）
├── styles.css # 共享CSS（从templates/复制）
├── build.js # HTML合并脚本（从templates/复制，改FRAGMENT_ORDER）
├── build-pdf.js # Playwright PDF渲染（从templates/复制）
├── update.sh # 一键版本更新（从templates/复制）
├── version.json # {"version":"1.0.0","build":1,"lastUpdate":"","title":""}
├── CHANGELOG.md # 更新日志
├── fragments/ # 内容片段（纯HTML，不含<html><head>）
│ ├── 00-cover.html / 01-toc.html
│ ├── part{N}-{中文简称}.html
│ ├── appendix.html / 99-backpage.html
├── research/ # 调研资料
├── output/ # {title}-v{version}.html/.pdf
└── versions/ # 历史PDF存档
```
## 阶段1：调研
1. 与用户确定主题和目标读者安装后查看完整内容 ↓