القائمة
写"橙皮书"风格的技术书/实战手册——从选题、章节大纲、分章写作、审校到渲染成出版级 A4 PDF。当用户要把一个技术主题（某个工具、框架、概念）做成一本结构化、可下载、读起来不像 AI slop 的免费技术书/指南/手册/电子书时使用。触发词：橙皮书、技术书、实战手册、电子书、PDF 教程、把 X 做成一本书。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | write-orange-book |
| description | 写"橙皮书"风格的技术书/实战手册——从选题、章节大纲、分章写作、审校到渲染成出版级 A4 PDF。当用户要把一个技术主题（某个工具、框架、概念）做成一本结构化、可下载、读起来不像 AI slop 的免费技术书/指南/手册/电子书时使用。触发词：橙皮书、技术书、实战手册、电子书、PDF 教程、把 X 做成一本书。 |
一套把技术主题写成出版级 PDF 手册的完整工作流。复刻的是"焦橙主题"设计系统 + 分章 HTML 源 + 脚本渲染 PDF 的产线。
和用户确认四件事，缺一不可：
不要在用户没给清楚这四点时就开始生成内容。模糊就追问。
section-intro）。chapters/NN-slug.html（如 02-quickstart.html）。00 留给封面，99 留给尾页。<html>/<head>/<style>——CSS 由渲染脚本统一注入。section-title → section-en（英文副标题，可选）→ section-intro（导语）→ 正文。references/components.md 里的组件积木（callout / tip / warning / step / flow / compare / code / table / file-tree）。不要发明新组件类名，否则没有样式。references/writing-guide.md。核心：短句、给具体数字和真实案例、避免空泛的"赋能/抓手"式 AI 腔。chapters/00-cover.html、尾页 chapters/99-backpage.html：从 references/components.md 复制模板填字段。<em> 包住要变焦橙色的词。python scripts/build_pdf.py book.config.json
脚本会：按 config 顺序拼接所有 chapters → 自动生成目录页 → 内联 theme.css → 输出 A4 PDF 到 dist/。
依赖：pip install weasyprint（首选，纯 Python）。
references/review.md 跑三遍法（内容 / 降 AI 腔 / 节奏排版）。如果用户装了 huashu-proofreading skill，优先调它当审校引擎；否则用 review.md 里内置的等效清单。技术书的人味靠真实踩坑、版本差异、"我实测…"的数字——多写这些。page-break-inside:avoid，超长的仍会断）、目录页码对、焦橙色只用在该强调处。发现问题改 chapter 片段再重渲染。book/
├── book.config.json # 元信息 + 章节顺序
├── chapters/
│ ├── 00-cover.html
│ ├── 01-xxx.html
│ └── 99-backpage.html
└── dist/book.pdf
@page 只管上下，左右靠 .content 的 padding。不要两处都设左右边距，会叠加出血。#C2410C 是唯一强调色，克制使用——全篇高亮等于没有高亮。详见 references/components.md（组件速查）、references/writing-guide.md（写作方法论）和 references/review.md（审校层）。