用途：把包含有序 Markdown 章节的目录转换成单一、带样式的 PDF 书籍，适合将技术文档、多章节资料导出为可打印或可分享的版本。Markdown 文件是唯一数据源，PDF 只是派生产物，不应直接编辑 PDF。
主要能力：生成含二级目录的表格；页脚居中页码；每个 h1 章节另起一页；把章节间的 .md 链接改写为文档内 #anchor 内部链接；标题取自 README.md 的首个 # 标题，缺失时回退为目录名；对无法解析的 .md 链接给出警告。
必要依赖：pandoc（brew install pandoc，负责 Markdown 转 HTML）、weasyprint（uv tool install weasyprint，负责 HTML 转 PDF）、pango（brew install pango，weasyprint 的排版依赖）。运行前可用 command -v pandoc、command -v weasyprint 检查；缺失时脚本会报错退出。
使用方式：运行 ${CLAUDE_PLUGIN_ROOT}/skills/pdf-generation/scripts/generate-pdf.sh <input-dir> [output.pdf]。input-dir 为有序 Markdown 章节所在目录，output.pdf 可选，默认输出为 <input-dir>/technical-overview.pdf。若 $CLAUDE_PLUGIN_ROOT 未设置，可按资料中的 find 命令在 ~/.claude/plugins 下定位脚本，再以 "$SCRIPT_PATH" <input-dir> [output.pdf] 执行。
目录结构：需遵循 README.md 在前，随后 00-.md 至 99-.md，再到 appendix-*.md 的命名顺序。链接需使用相对路径，可带锚点；每章应有且仅有一个 # 标题，用于解析链接目标，链接目标文件需位于同一目录。
样式与限制：脚本内嵌打印优化 CSS，默认 US Letter、上下 1 英寸页边距、系统字体栈、代码块 9pt 灰底、表格带边框与隔行颜色；详细定制见 references/css-customization.md。已知问题包括链接无法解析的警告、字体显示异常、空 PDF 或未发现章节、长代码块溢出等；若在插件上下文之外运行可能出现 CLAUDE_PLUGIN_ROOT 为空。收费、价格与平台信息暂未提供。