用途
pdf 是一组 PDF 与文档实用工具技能，围绕技能（skills）、目录（catalogs）和示例（examples）的 PDF 导出展开，目标是生成可良好分发的文档。它覆盖从内容转换、文件合并到结果校验的完整流程，并强调与 CI 配合使用。
主要能力
- 转换：把 Markdown 文件或 SKILL.md 内容按简洁模板转换为 PDF。
- 合并：将多个 PDF 文件合并为一个可分发的单一包。
- 校验：校验 PDF 文本提取与基础无障碍性。
- 变更摘要：根据 SKILL.md 的差异（diff）生成 PDF 变更摘要。
- 目录生成：从 skills/CATALOG.md 或 docs/ 生成可打印目录。
- 元数据：在生成的 PDF 中嵌入元数据与版本信息。
- CI 检查：提供适合 CI 的检查，确保 PDF 构建不报错。
- 本地工作流：提供本地 PDF 生成工作流的命令或代码片段。
使用方式
资料提供了若干关键提示词示例，可作为使用入口。
生成类：
- "Convert skills/hr-recruiting/SKILL.md to a single-column PDF with header/footer."
- "Produce a merged PDF of docs/README.md and skills/CATALOG.md for release."
- "Generate a one-page PDF summary for skill: [skill name] with metadata."
- "Export examples/ai/hiring-a-senior-ai-engineer.md to PDF with code blocks rendered."
校验与 CI 类：
- "Check that generated PDF contains specified headings and no broken images."
- "Run PDF accessibility basic checks and report issues."
- "Create a CI step that fails if PDF generation errors occur."
- "Extract text from a PDF and diff against source Markdown for verification."
模板与样式类：
- "Provide a minimal PDF template with header, footer, and repo branding guidelines."
- "Suggest CSS or print styles for rendering code blocks clearly in PDFs."
- "Generate a one-page changelog template to include in release PDFs."
- "Recommend font and margin settings suitable for both screen and print."
适用场景
- 将 SKILL.md 或 Markdown 文档导出为格式统一的 PDF，用于分发。
- 把多个 PDF 合并为一个发布包。
- 在 CI 中生成 PDF 产物并纳入发布包。
- 从 skills/CATALOG.md 或 docs/ 生成可打印目录。
- 为每个发布版 PDF 附带简要变更日志页。
提示与限制
- 建议使用轻量工具（pandoc、wkhtmltopdf 或 headless Chromium），并与 Bun CI 镜像兼容。
- 保持模板极简，避免不同环境间的渲染差异。
- 在 CI 产物中生成 PDF，用于发布包。
- 每个发布版 PDF 建议包含 skills/CATALOG.md 和一页简短变更日志。
- 资料未提供具体安装命令、命令行参数、支持平台、收费或价格信息，这些内容暂未提供。