用途:为 AI 助手提供生成专业、视觉统一的 PDF 报告的规范,适用于执行摘要、分析研究、对比基准、事故复盘等长文阅读场景。
主要能力:内置 midnight、forest、coral、terracotta、ocean、charcoal、teal、berry、sage、cherry 等主题,可用 pdf.set_theme('name') 应用,也可直接设置 pdf.COLORS 自定义配色;提供 get_chart_palette() 让 matplotlib 图表与报告配色统一。PDFReport 辅助方法包括 add_title_page、add_section、add_body、add_callout_box、add_quote_strip、add_kpi_strip、add_labeled_item、add_numbered_item、add_chart、add_table、add_table_wrapped、add_formula、ensure_space 等。
使用方式:从 /tmp/skills/pdf/scripts 导入 PDFReport、THEMES、render_formula;初始化时设置页面、边距、主题与页码;按标题页、执行摘要、背景、方法、发现、讨论、结论、建议的顺序组织内容;图表需 dpi=150 以上并配 Figure N 说明与解读段落。
限制与注意:正文需满足 WCAG 对比度(正文 4.5:1、标题 3:1);避免重边框、3D 图表、剪贴画与彩虹配色;复合元素需先调用 ensure_space() 防止分页渲染异常;多行代码应使用 add_code_block();matplotlib 需先设 Agg 并在保存后 plt.close()。详细实现见 references 下的 components.md、charts.md、technical.md。