深度调研主题，生成100页以上书籍级PDF手册。采用模块化HTML片段结构、语义化版本管理、多Agent并行写作、Playwright渲染PDF。当用户需要完整PDF手册、电子书、橙皮书、参考指南时触发，即使仅说「做一本书」「做个PDF手册」「做个完整指南」「做一本XX的手册」亦触发。
Book-PDF：书籍级PDF手册全流程
功能概述
Book-PDF：书籍级PDF手册全流程是一项面向实际任务的技能，主要用于从一个主题到100页+专业PDF；五个阶段：调研 → 规划 → 写作 → 构建 → 版本更新；
核心要点
- Node.js >= 16；
- Playwright： npm install playwright && npx playwright install chromium；
- 参考资料导航；
使用与执行
需要时读取；写HTML片段时；references/design。它将相关步骤、工具调用和结果整理方式集中到统一流程中，帮助使用者更快完成目标并减少重复操作。从功能定位来看，该技能强调把分散的操作要求整理成清晰、可复用的处理流程，使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
结果检查与注意事项
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数，再依据技能说明逐步执行；若输入条件不完整，应先补齐信息或采用保守配置，避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期，并对异常提示、缺失字段和边界情况进行处理；涉及批量任务时，还应保存进度，避免中断后重复操作。该技能适合用于一次性任务，也可以接入自动化工作流，与其他技能或上层代理配合完成更完整的业务链路；在组合使用时，应明确每一步的输入输出关系，并避免不同步骤之间出现参数冲突。
Book-PDF：书籍级PDF手册全流程
从一个主题到100页+专业PDF。五个阶段：调研 → 规划 → 写作 → 构建 → 版本更新。
前置依赖
- Node.js >= 16
- Playwright：
npm install playwright && npx playwright install chromium
参考资料导航
| 需要时读取 | 文件 | 内容 |
|---|---|---|
| 写HTML片段时 | 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 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，不含）
│ ├── 00-cover.html / 01-toc.html
│ ├── part{N}-{中文简称}.html
│ ├── appendix.html / 99-backpage.html
├── research/ # 调研资料
├── output/ # {title}-v{version}.html/.pdf
└── versions/ # 历史PDF存档
阶段1：调研
- 与用户确定主题和目标读者
- 拆分调研维度（6-10个方向）
- 启动多个background agent并行调研，每份保存到
{项目目录}/research/YYYY-MM-{关键词}.md - 调研完成后汇总，进入规划
阶段2：规划
编辑项目目录下的 PROJECT.md，包含：
- 章节大纲表（Part + 节号 + 标题 + 核心内容 + 信息来源）
- 调研资料索引（路径 + 摘要 + 状态）
- Agent并行分工方案（关联性强的Part分给同一个agent）
- 进度追踪表 + 关键数据速查
修改 build.js 中的 FRAGMENT_ORDER。与用户确认大纲后进入写作。
阶段3：写作
多Agent并行，每个agent输出一个HTML片段。
每个写作agent需要：
- 读取 references/design-system.md 了解可用组件和片段结构规范
- 读取对应调研资料
- 输出纯HTML片段（不含