Cookbook Forge

要解决的问题

写一本技术 CookBook、手册或综述时，资料通常散落在网页、PDF、EPUB、GitHub 仓库、arxiv 论文和本地文档里。手动整理成结构化长文，再分别适配 LaTeX PDF、在线站点和 EPUB 发布格式，重复劳动量大，转换过程也容易出错。

技能如何工作

Cookbook Forge 以 MDX 为权威中间格式，每章独立为一个 .mdx 文件，再按需求转换。

• 资料穷尽式采集：遍历 URL、GitHub、arxiv、PDF/EPUB、本地目录，并做网络补充搜索，建立 metadata/sources.md 溯源清单。
• 架构先行：先生成全景图与章节大纲 metadata/outline.md，经用户确认后才逐章写作。
• 章节结构：每章包含章节引入、本章地图、原理与带中文注释的代码、Recipes、常见陷阱、要点总结和参考文献，遵循 O'Reilly CookBook 与 Springer Handbook 的行文布局。
• 图表支持：mermaid、plantuml、drawio、excalidraw、chart 视需求选用，每章至少 1–2 张图。
• 多格式输出：mdx/、latex-pdf/、nextra-site/、epub/ 各占独立子文件夹。
• LLM 驱动转换：lmdx2tex.mjs 和 lbuild-epub.mjs 通过子 agent 逐章调用 LLM 完成 MDX→LaTeX 和 MDX→EPUB，避免正则转换的脆弱性。
• EPUB 合规打包：用 Python zipfile 保证 mimetype STORED 且位于首位，打包后二次校验。

适用边界

• 单篇博客、短文或单页文档不需要这个技能，直接写 MDX 即可。
• 仅做 LaTeX→Nextra 网站转换、仅优化 EPUB 排版、仅 MD→PDF 排版，有对应的专用 skill。
• 默认目标字数 8 万字以上，需要用户提供明确主题与资料源；无法访问的资料会明确说明，不会悄悄丢弃。