Cookbook Forge

Generates deep technical CookBooks, Handbooks, and Surveys from user materials (websites, PDFs, EPUBs, GitHub repos, arxiv papers, docs). Produces MDX chapters first, then ElegantBook LaTeX/PDF, Nextra website, and optimized EPUB. Invoke when user asks to write a Cookbook, handbook, survey, technical book, or structured long-form documentation for a project/domain.

Samon Yu@samonysh

Install

openclaw skills install @samonysh/cookbook-forge

Cookbook Forge

Domain CookBook / Handbook / Survey 生成器。从用户提供的自然语言需求与多源资料（网页、PDF、EPUB、GitHub、arxiv 论文、项目文档等）出发，按照 O'Reilly CookBook 与 Springer Handbook 的行文布局风格，先生成章节化 MDX（基于 unified/MDX），再按用户指定转换为：

ElegantBook LaTeX 工程 + PDF
Nextra v3 电子文档网站
优化排版的 EPUB（贴近 ElegantBook 样式，适配电子阅读器）

默认输出 MDX；用户可指定任意子集组合。每个输出格式独占一个子文件夹。

触发条件

满足以下任一条件时调用本 Skill：

用户要求为某个项目、技术栈、主题、领域写一本 CookBook / 手册 / 综述 / 技术书。
用户提供多种资料（网页、PDF、EPUB、GitHub 仓库、arxiv 链接、本地文档）要求整理为结构化长文档。
用户要求输出 LaTeX/PDF、在线网站、EPUB 中的任一或多个格式，且源头是结构化的多章内容。
用户要求参考 O'Reilly CookBook 或 Springer Handbook 风格写作。
用户提到 "Cookbook"、"手册"、"综述"、"Handbook"、"技术书"、"生成教程长文"、"整本书" 等关键词。

何时不调用

单篇博客/短文/单页文档 → 直接写 MDX/Markdown 即可。
用户仅要求转换已有 LaTeX → Nextra 网站而没有原始资料采集/写作阶段 → 用 latex-to-nextra-site。
用户仅要求优化 EPUB 排版 → 用 epub-reader-optimizer。
用户仅要求把 MD/笔记排版成 PDF → 用 elegantbook-latex。

必须联动的 Skills 与工具

本 Skill 是编排型 Skill，执行时按需联动以下能力（由主 agent 在调用本 skill 后自行调度，或由本 skill 描述指示）：

能力	用途
`agent-browser` / `vivaldi-automation`	爬取网页、抓取站点地图、遍历文档站
`WebFetch` / `WebSearch`	获取网页内容、网络搜索补充资料
`arxiv-watcher` / `connected-papers-browser`	获取 arxiv 及相关论文
`doc2x-cli`	PDF OCR/解析为 Markdown/文本
`gh-cli`	读取 GitHub 仓库结构、README、源码、docs
`plantuml` / `drawio` / `excalidraw` / `chart-visualization`	生成图表（架构图、类图、时序图、流程图、数据图表）
`elegantbook-latex`	编译 ElegantBook LaTeX → PDF
`Read` / 文件读取	本地 EPUB、MD、代码、PDF 文本提取

本 Skill 自带 assets 与 scripts：

scripts/epub-zip.mjs — EPUB 合规打包（Node 内置 zlib 手写 ZIP，零依赖；保证 mimetype STORED 且为第一；打包后遍历 central directory 二次校验）。
scripts/subset-fonts.mjs — 字体子集化（基于 fonteditor-core，TTF → WOFF2；未安装时会提示 npm install fonteditor-core 并给出 Python fallback 命令）。
scripts/optimize-formula-images.mjs — 公式即图片型 HTML 结构修复（纯 JS 正则替换）。
scripts/mdx2tex.mjs — MDX → ElegantBook LaTeX 转换器（先按 code fence 分块，避免代码内 #/{}/_ 被转义；从 frontmatter 读 title；支持 callout→tcolorbox、表格→tabularx、图片→figure、列表→itemize）。
scripts/word-count.mjs — 字数统计（GFM 表格按"表头+分隔行"块计数，不再虚高）。
scripts/build-epub.mjs — MDX → EPUB 完整构建（tokenize-first 转换；callout→div.class；代码块不被 heading 正则误伤；自动拷贝图片并登记 MIME；CSS 追加 callout/math/table/code 样式）。
scripts/kroki-render.mjs — PlantUML 通过 Kroki.io 远程渲染（deflate+base64url 编码 GET，含隐私提示）。
assets/nextra-template/scripts/scaffold-nextra.mjs — 把模板里的 {{BOOK_SLUG}}/{{BOOK_TITLE}}/{{GITHUB_REPO_URL}}/{{YEAR}} 占位符替换为真实值，自动拷贝 mdx→pages/zh、figures→public/figures、生成 pages/en 英文骨架。
assets/stylesheet.template.css / assets/stylesheet.formula-image.css — EPUB 样式表。
assets/template-mdx/ — 单章 MDX 模板（含 $$ 块级公式写法约定）。
assets/nextra-template/ — Nextra 站点骨架（已启用 mermaid + KaTeX）。
references/style-guide-oreilly.md — O'Reilly CookBook 行文布局参考。
references/style-guide-springer.md — Springer Handbook 行文布局参考。

总体目标

产出一本面向目标读者（默认是中高级开发者/架构师/研究者）的深度书籍。要求：

资料穷尽：对用户提供的所有资料都尽力抽取；对缺失资料进行网络/论文搜索补充。
架构先行：先出整体全景图与章节目录，与用户对齐后再逐章写作。
每章一个 MDX：使用 MDX（MDXJS + unified）作为权威中间格式，每章独立文件，便于多格式转换。
内容深入：兼顾原理与实用，包含背景引入、章节地图、正文、代码（带注释）、图表、表格、Recipe、陷阱、要点总结、参考文献。
图表丰富：至少每章 1–2 张图（mermaid/plantuml/drawio/excalidraw/chart 视用户要求而定），表格按需。
字数可配置：默认 8 万字以上；可按需求调整（短篇手册 2–3 万字，综述 3–5 万字，完整 CookBook 8–15 万字）。
多格式输出：默认 MDX；按用户指定输出 mdx/、latex-pdf/、nextra-site/、epub/ 子文件夹。

标准输出目录

text

<BookSlug>/
├── mdx/                              # 权威中间格式（默认必出）
│   ├── index.mdx                     # 封面/扉页
│   ├── preface.mdx
│   ├── ch00-overview.mdx             # 全景图章
│   ├── ch01-xxx.mdx
│   ├── ...
│   ├── appendix-a.mdx
│   ├── references.mdx
│   ├── _meta.ts                      # 章节顺序（Nextra 兼容）
│   └── public/
│       ├── figures/                  # 图片 / 渲染后的图表
│       └── diagrams-src/             # plantuml/.drawio/mermaid 源
├── latex-pdf/                        # 当用户要求 PDF 时生成
│   ├── latex/
│   │   ├── main.tex
│   │   ├── elegantbook.cls
│   │   ├── chapters/
│   │   ├── figures/
│   │   ├── diagrams/
│   │   └── metadata/
│   └── dist/<BookSlug>.pdf
├── nextra-site/                      # 当用户要求网站时生成
│   ├── package.json
│   ├── next.config.mjs
│   ├── theme.config.tsx
│   ├── middleware.js
│   ├── pages/zh/*.mdx
│   ├── pages/en/*.mdx                # 英文骨架（可选）
│   ├── public/figures/
│   ├── scripts/
│   ├── Dockerfile
│   └── docker-compose.yml
├── epub/                             # 当用户要求 EPUB 时生成
│   ├── <BookSlug>.epub
│   └── build/                        # 解包/构建中间目录（交付前可清理）
└── metadata/
    ├── sources.md                    # 所有参考资料来源
    ├── image-sources.md
    ├── word-count.txt
    └── outline.md                    # 最终章节大纲（与用户对齐版）

工作流程

阶段 0：输入识别与参数对齐

识别用户输入：

主题/领域（自然语言描述）
资料清单：URL（网页、文档站、arxiv、GitHub）、本地文件（PDF、EPUB、MD、代码目录）
目标读者：初学者 / 中级 / 高级 / 研究者 / 架构师
目标字数（默认 8 万字）
输出格式：MDX（默认）/ PDF / Nextra 网站 / EPUB，可组合
图表工具偏好：mermaid / plantuml / drawio / excalidraw / chart
主语言：中文（默认）/ 英文 / 双语
是否需要封面（默认需要）
GitHub 仓库 URL、站点名、Logo（用于 Nextra 站部署）

若有缺失，用 AskUserQuestion 简洁询问，不要一次问超过 4 个问题。

阶段 1：资料采集（穷尽式）

按以下顺序穷尽资料，建立 metadata/sources.md：

用户提供的 URL/文件：
- 网页 → 用 WebFetch 抓正文；若是文档站，遍历 sitemap.xml 或导航栏抓取所有相关页。
- GitHub 仓库 → 用 gh-cli 读取 README、docs/、examples/、源码关键目录、CHANGELOG、issues/PR 中的设计讨论。
- arxiv 论文 → 用 arxiv-watcher 获取摘要、全文 PDF；如需相关论文用 connected-papers-browser。
- PDF → 用 doc2x-cli 做 OCR/解析为 Markdown；扫描版优先 OCR。
- EPUB → 解包后读取 XHTML 章节文本。
- 本地代码目录 → 用 SearchCodebase/Grep/Read 分析目录结构、关键模块、入口。
网络补充搜索：
- 官方文档未覆盖时，用 WebSearch 搜博客、演讲、RFC、设计文档。
- 交叉验证关键事实，至少 2 个来源。
用户的其他相关 skills → 若用户工作区有领域特定 skill（如某框架内部 skill），读取其 SKILL.md 作为领域知识。

每条资料记录：URL/路径、标题、作者/组织、访问日期、使用章节。

阶段 2：全景图与章节大纲设计（架构先行）

参考 O'Reilly CookBook 与 Springer Handbook 结构，产出 metadata/outline.md：

典型结构（按书的规模缩放，短篇手册可精简）：

text

00 前言、目标读者、阅读路线、致谢
01 领域/项目全景图（含一张总览架构图，必读）
02 基础概念与术语
03 快速开始 / Hello World / 最小可运行示例
04 安装、环境、构建系统
05 核心概念与编程模型
06 整体架构（架构图）
07 关键模块/子系统深度解析（分多章）
08 核心调用链/生命周期/数据流（时序图/流程图）
09 配置、扩展、插件机制
10 实战 Recipes（至少 10–20 个任务导向案例）
11 性能、安全、可观测性、错误处理
12 测试与调试
13 部署与生产实践
14 生态、对比、路线图
15 总结与展望
附录 A API/配置速查表
附录 B 术语表
附录 C 参考资料

每章在大纲中写明：

章节目标（读者读完能做什么）
在全书中的位置（与哪些章相互引用）
预估字数
必含图表/表格/代码块数
依赖的来源资料

必须用 AskUserQuestion 把 outline.md 发给用户确认后再进入写作阶段。

阶段 3：逐章 MDX 写作（权威中间格式）

每章一个 .mdx 文件，放入 mdx/。章节命名规则 chNN-slug.mdx，附录 appendix-X-slug.mdx。

MDX frontmatter 规范

mdx

---
title: "第 1 章 项目全景图"
chapter: 1
slug: "ch01-overview"
wordCountTarget: 4000
status: "draft"
references:
  - "https://example.com/docs"
  - "sources.md#section-1"
---

章节内部结构（必须遵循）

参考 references/style-guide-oreilly.md 与 references/style-guide-springer.md，每章按如下模板组织（来自 assets/template-mdx/chapter-template.mdx）：

章节引入（Why this matters）：告诉读者为什么需要这一章，解决什么问题，这一章在整体中的位置（链接到全景图章）。
本章地图（Chapter Map）：用 callout 卡片列出章内小节结构。
正文小节：每个小节：
- 原理（Why / How it works）
- 实用（How to use it / 代码示例，代码必须带中文注释）
- 表格（对比、参数、配置项）
- 图（mermaid/plantuml/drawio/excalidraw/chart）
- 关键术语（首次出现加粗）
Recipes（可选但推荐）：任务导向的小案例，包含 Problem / Solution / Discussion / See Also。
常见陷阱（Pitfalls）：callout 警告框，列出踩坑点。
章节总结（Key Points）：callout 要点框，3–7 条要点。
延伸阅读（See Also）：指向其他章节与外部资料。
参考文献：章末列出本章引用的 sources 条目。

图表规范

mermaid：直接用 ```mermaid 代码围栏，Nextra 客户端渲染；导出 PDF 时通过 mermaid-cli 渲染为 PNG/SVG。
plantuml：源码存 mdx/public/diagrams-src/*.puml，渲染为 SVG 放入 mdx/public/figures/。渲染后端选择优先级（根据可用工具）：
1. Docker（推荐，零外网依赖）：docker run --rm -v <srcDir>:/data -v <outDir>:/out plantuml/plantuml:latest -charset UTF-8 -output /out -tsvg /data/<file>.puml；每个 .puml 必须含 skinparam defaultFontName "WenQuanYi Micro Hei"；渲染脚本（scripts/render-plantuml.mjs）必须同时产出"按文件名"与"按 @startuml alias"两份 SVG 以避免 404。
2. Kroki.io（远程，opt-in）：node scripts/kroki-render.mjs <input.puml> <output.svg> 走 https://kroki.io/plantuml/svg/<deflate-base64url>。注意 Kroki 运行的 PlantUML 版本较旧，不支持 <style> CSS 块，必须使用 skinparam 变体（见 assets/template-mdx）。会把 .puml 源码 POST 到 kroki.io，涉密图不要用。
3. 本地 plantuml.jar（需要 Java）：离线 fallback。
drawio：.drawio 源码存 diagrams-src/，导出为 .drawio.svg。
excalidraw：.excalidraw 源码 + 导出 PNG/SVG。
chart（数据图表）：用 chart-visualization skill 生成 PNG/SVG。

每张图必须：

有编号（如图 1-1）和标题
在正文中被引用（"如图 1-1 所示"）
有说明段落

表格规范

使用标准 GFM markdown 表格（MDX 支持）。
宽表用 <div className="overflow-x-auto"> 包裹。
导出到 LaTeX 时自动转为 booktabs/tabularx（由后续脚本处理）。

代码规范

使用围栏代码块 + 语言标识（python / typescript 等）。
代码必须有中文注释解释关键步骤。
代码块可加标题注释（如 # file: src/core/engine.py）。
长代码（>50 行）拆为多块，每块前后有解释文字。

MDX 语法注意

正文裸 <、>、{、} 必须转义或包在代码块/反引号中。
中文段落与英文/数字之间保留半角空格（中英文混排规范）。
数学公式：行内 $E=mc^2$ ，块级 $$...$$（KaTeX 兼容）。
所有跨章引用用 markdown 链接形式：[见第 3 章](./ch03-xxx.mdx)。

阶段 4：字数统计与补足

写完所有章节后：

用脚本统计每章中文字符、英文词数，生成 metadata/word-count.txt。
若未达目标字数，按以下优先级扩写（禁止空话填充）：
1. 新增 Recipes（任务导向）
2. 加深源码/原理分析
3. 扩展配置项/API 速查表
4. 增加对比表格、故障排查章节
5. 补充附录
再次统计直到达标或明确说明缺口原因。

阶段 5：多格式转换（按用户要求）

5a. MDX（默认必出）

直接保留 mdx/ 目录。
生成 mdx/_meta.ts（章节顺序 + separator 分组）。
图表全部就位，mermaid 保留为代码围栏，其他图表渲染为 SVG/PNG。
输出 README 说明 MDX 结构与后续转换方法。

5b. ElegantBook LaTeX + PDF

调用 elegantbook-latex skill，按以下流程：

在 latex-pdf/latex/ 下初始化 ElegantBook 工程（参考 project-cookbook-latex 的目录规范）：
- main.tex 全局配置 + \input{chapters/...}
- chapters/ 每章一个 .tex
- figures/ 放图片（从 mdx/public/figures/ 拷贝）
- diagrams/ 放图表源
- metadata/ 放 sources / word-count / build-notes
MDX → LaTeX 转换（写 scripts/mdx2tex.mjs 或 pandoc + 后处理），关键映射：
- # 标题 → \chapter{} / \section{} / \subsection{}
- **粗体** *斜体* → \textbf{} \emph{}
- 表格 → booktabs + tabularx，宽表用 xltabular/longtable
- 代码围栏 → tcolorbox + listings 环境（见 project-cookbook-latex §10）
- <div className="callout xxx"> → \begin{tcolorbox}[...] 自定义环境
- 图片 → \includegraphics + \begin{figure}
- $...$ / $$...$$ 数学公式原样保留
- 跨章链接 → \ref{ch:xx} / \autoref
封面图片必须 1280×1024（见 project-cookbook-latex §6），记录来源。
用 XeLaTeX 两遍编译生成 PDF。
强制质量闸门（来自 project-cookbook-latex §质量闸门）：
- PDF 不得出现 Markdown 表格源码
- 表格必须 LaTeX 环境，不得过挤
- 代码块必须 tcolorbox/listings
- 封面非空
- 字数达标
- LaTeX 可复现编译

5c. Nextra v3 网站

参考 latex-to-nextra-site skill，流程：

在项目根下初始化 Nextra 工程：从 assets/nextra-template/ 拷贝骨架到 nextra-site/。
运行 node nextra-site/scripts/scaffold-nextra.mjs --slug <BookSlug> --title "<Book Title>" --github <URL> --year <YYYY>：
- 把 package.json/theme.config.tsx/docker-compose.yml 里的 {{XXX}} 占位符替换为真实值
- 自动拷贝 mdx/*.mdx → nextra-site/pages/zh/*.mdx（图片路径自动从 public/figures/ 改为 /figures/）
- 自动生成 pages/en/*.mdx 英文占位骨架（"English translation in progress"）
- 自动拷贝 mdx/public/figures/* → nextra-site/public/figures/
图表：PlantUML 用 Docker 或 Kroki 渲染为 SVG/PNG；drawio 导出 .drawio.svg；其他图片拷贝到 public/figures/。
运行 npm install。
运行 npm run prepare:meta 生成 pages/zh/_meta.ts（含 separator 分组，reading-order 编号）。
若阅读顺序 ≠ 文件名字典序，跑 scripts/renumber-content.mjs 把"第 N 章"引用链接化（幂等，跳过已链接部分）。
next.config.mjs 已启用 KaTeX + mermaid + standalone 输出；theme.config.tsx 配 i18n、logo、暗色模式、搜索、mermaid 开关。
middleware.js 根路径重定向到 /zh。
styles/globals.css 含 callout/figure/表格滚动/下载按钮样式。
npm run build 必须成功（warning 允许，error 必须为零）。
写 Dockerfile + docker-compose.yml（三阶段构建 + healthcheck），docker compose up -d --build 验证 healthy。
写 DEPLOY.md 说明 GitHub + Vercel + Docker 三路部署。

关键陷阱（务必遵守）：

PlantUML 必须用 Docker plantuml/plantuml:latest，不要用内置 PS1 脚本（GBK PowerShell 会失败）。
每个 .puml 必须含 skinparam defaultFontName "WenQuanYi Micro Hei"，否则中文豆腐块。
PlantUML 输出文件名由 @startuml NAME 决定，脚本必须同时产出 "按文件名" 与 "按 alias" 两份 SVG/PNG。
MDX 中裸 </> 必须转义为 </>。
npm run build 出现 [nextra] Next.js doesn't support i18n by locale folder names 是已知告警，可忽略。

5d. EPUB

从 mdx/ 权威内容生成 EPUB（不是从 PDF/LaTeX 反推）：

MDX → XHTML（每章一个 xhtml，去掉 JSX 仅保留 HTML 语义标签）。
在 epub/build/ 下建立 EPUB3 结构：
- mimetype（第一文件，STORED，内容固定 application/epub+zip）
- META-INF/container.xml
- OEBPS/content.opf（清单 + spine + 元数据）
- OEBPS/toc.ncx + nav.xhtml（导航）
- OEBPS/Text/*.xhtml
- OEBPS/Images/（拷贝图）
- OEBPS/Fonts/（LXGW WenKai 子集化 WOFF2）
- OEBPS/css/stylesheet.css
CSS 使用本 Skill 自带的 assets/stylesheet.template.css 作为基础样式，若内容包含公式图片场景则额外引入 assets/stylesheet.formula-image.css，要求：
- 强制白底黑字（防编辑器误触发 dark scheme）
- 中文字体栈：LXGW WenKai / 霞鹜文楷 / Source Han Serif / SimSun
- 代码字体：LXGW WenKai Mono
- 代码块 tcolorbox 风格（边框 + 浅灰背景 + 左侧蓝条）
- 表格 booktabs 风格（顶/底粗线 + 行间细线）
- 响应式图片
字体必须子集化嵌入（14MB TTF → ~300KB WOFF2），用 scripts/subset-fonts.mjs：
- 优先通过 fonteditor-core（npm install fonteditor-core）从 xhtml 收集实际使用字符后做 TTF→WOFF2 子集化
- 若未安装，脚本会提示安装命令，并给出 Python (fonttools+brotli) fallback 命令
- 在 content.opf 登记 media-type="font/woff2"
若内容含"公式即图片"场景，用 scripts/optimize-formula-images.mjs 修复 HTML 结构。
用 scripts/epub-zip.mjs 打包（手写 ZIP，mimetype STORED 且为第一；零依赖）。
自检：
- mimetype 是第一个条目且 STORED
- namelist()[0] == "mimetype"
- 所有图片/字体/章节均在 manifest 中
- 章节在 spine 中顺序正确

EPUB 样式贴近 ElegantBook（中文衬线/楷体、蓝色标题、代码块左侧蓝条），但要兼容老旧电子阅读器：

不使用 flex/grid 复杂布局
颜色用 !important 覆盖阅读器主题
禁用 @media (prefers-color-scheme: dark) 块（防白底白字）

阶段 6：最终交付

在 metadata/word-count.txt 写入最终统计（中文字符、英文词数、估算总字、章节数、Recipe、表格、代码块、图表数）。
在 metadata/sources.md 列出所有参考资料。
在根目录写中英文 README（见下文）。
清理中间构建目录（epub/build/、latex/latex/.aux 等）。
最终回复给用户：
- 各输出格式子文件夹链接
- 章节数 / 字数 / 图表数统计
- 本地预览命令（Nextra：cd nextra-site && npm install && npm run dev；PDF：直接打开 PDF；EPUB：直接打开）
- 未完成项/资料限制说明

强制质量闸门

交付前必须逐项打勾：

中英文 README 要求

每个生成的书籍项目根目录必须包含：

README.md（中文）：简介、目录、本地产出、格式说明、贡献指南
README.en.md（英文）：同上英文版
若输出 Nextra：DEPLOY.md 说明 GitHub/Vercel/Docker 部署

本 Skill 自身目录包含：

SKILL.md（本文件，英文 description，中文正文）
README.md（中文，skill 自身使用说明）
README.en.md（英文）

常见失败点速查

现象	根因	处理
PlantUML 中文豆腐块 □□□	.puml 未声明 CJK 字体	每个 .puml 加 `skinparam defaultFontName "WenQuanYi Micro Hei"`
PlantUML 图引用 404	输出名按 `@startuml NAME` 不按文件名	渲染脚本产出文件名 + alias 双份
Nextra 构建 MDX 解析错误 `<`	正文裸 `<` 被识别为 JSX	转义 `<`/`>` 或包反引号
Nextra `npm run build` i18n 告警	Nextra pages/zh + Next.js i18n 同存	已知告警，可忽略
Docker 构建后容器秒挂	`next.config.mjs` 未设 `output: 'standalone'`	开启 standalone；Dockerfile COPY public/
EPUB 文字变白看不见	阅读器误触发 dark scheme	强制白底黑字 `!important`；删掉 dark media 块
EPUB 嵌入字体让书变 30MB	用了完整 TTF	fontTools 子集化转 WOFF2，单字体 ~300KB
EPUB 打包后打不开	mimetype 不是第一/被压缩	必须 Python zipfile，mimetype STORED 优先写入
PDF 出现 `\| --- \|` Markdown 表格	未转 LaTeX 表格	mdx2tex 脚本必须把 GFM 表格转为 booktabs/tabularx
PDF 封面空白	图片不存在/尺寸错	严格 1280×1024；验证文件存在 + PDF 首页非空
跨章引用"第 N 章"编号错乱	reading order ≠ 文件名	跑 renumber-content.mjs 链接化
字数不够 8 万	只写了使用文档没深入原理/源码	扩写 Recipes、源码解析、配置速查、附录
资料受限无法抓取	网站有反爬/登录墙	不绕过限制；改用可访问来源并告知用户

示例用户请求

text

请基于 https://docs.dapr.io/ 和 GitHub 仓库 dapr/dapr，
以及《Dapr 实战》PDF 这本书，
生成一本 10 万字的 Dapr CookBook，
目标读者是中高级后端开发者，
输出 MDX + PDF + Nextra 网站，
图表用 plantuml 和 mermaid，
需要封面，网站名 Dapr CookBook，
部署到 Vercel。

执行：按上述阶段 0–6 全流程，最终交付 Dapr-CookBook/{mdx,latex-pdf,nextra-site}/。

禁止事项

不要把所有章写在一个 MDX 文件里 —— 必须每章独立。
不要跳过"大纲与用户对齐"直接开写。
不要忽略用户提供的任何资料（无法访问需明确说明）。
不要生成空话/凑字数段落；扩写必须是源码/Recipe/速查表。
不要用 PowerShell Compress-Archive 打包 EPUB（必须 Python zipfile）。
不要在 EPUB 里写复杂 flex/grid。
不要在 PDF 中保留 Markdown 表格/围栏源码。
不要使用 plantuml skill 自带 PS1 脚本（GBK locale 会失败），直接 docker run plantuml/plantuml:latest。
不要擅自 commit/发布到 GitHub，除非用户明确要求。

Cookbook Forge

Install

Cookbook Forge

触发条件

何时不调用

必须联动的 Skills 与工具

总体目标

标准输出目录

工作流程

阶段 0：输入识别与参数对齐

阶段 1：资料采集（穷尽式）

阶段 2：全景图与章节大纲设计（架构先行）

阶段 3：逐章 MDX 写作（权威中间格式）

MDX frontmatter 规范

章节内部结构（必须遵循）

图表规范

表格规范

代码规范

MDX 语法注意

阶段 4：字数统计与补足

阶段 5：多格式转换（按用户要求）

5a. MDX（默认必出）

5b. ElegantBook LaTeX + PDF

5c. Nextra v3 网站

5d. EPUB

阶段 6：最终交付

强制质量闸门

中英文 README 要求

常见失败点速查

推荐执行清单（Todo 模板）

示例用户请求

禁止事项

Related skills