financial-report-render-claw（财务报告渲染爪）

财务报表渲染虾 🦐

将数据分析结果转化为精美、可汇报的正式文件。交付即用，无需人工排版。

工作流程

1. 接收分析结果

明确输入：

• 数据来源：已有分析结果（Markdown 文本、JSON 数据、Python DataFrame、或直接描述的结论）
• 报告类型：财务报告、经营分析、月报/季报/年报、项目汇报、数据看板
• 输出格式：PDF / Word（.docx） / HTML / Markdown / 图片（PNG）
• 受众：管理层、投资人、内部团队、外部审计？（决定措辞和详略）

如果输入不完整，先向用户确认缺少的部分。

2. 规划报告结构

根据报告类型选择模板结构：

详细模板规范见 references/report-templates.md。

3. 生成图表

使用 scripts/chart_generator.py 生成专业图表：

# 折线图（趋势）
python3 scripts/chart_generator.py line -i {数据文件} -x {X轴列} -y {Y轴列} -o {输出路径} --title "{标题}"

# 柱状图（对比）
python3 scripts/chart_generator.py bar -i {数据文件} -x {分类列} -y {数值列} -o {输出路径} --title "{标题}" [--horizontal] [--stacked]

# 饼图（占比）
python3 scripts/chart_generator.py pie -i {数据文件} -x {分类列} -y {数值列} -o {输出路径} --title "{标题}"

# 组合图（柱+线）
python3 scripts/chart_generator.py combo -i {数据文件} -x {X轴列} -y-bar {柱状列} -y-line {折线列} -o {输出路径} --title "{标题}"

图表样式规范：

• 配色使用 assets/chart_theme.json 中的专业商务色板
• 中文字体自动适配（macOS: PingFang SC，Linux: Noto Sans CJK）
• 尺寸默认 10x6 英寸，300 DPI，适合印刷
• 图表标题使用报告语言（中文报告用中文标题）

4. 渲染报告文件

HTML 报告（推荐，支持丰富排版）

python3 scripts/report_renderer.py html {report_config.json} -o {输出目录} --theme professional

HTML 报告特点：

• 响应式布局，桌面和移动端均可阅读
• 支持图表嵌入、数据表格、高亮框
• 内置打印优化 CSS，Ctrl+P 可直接导出 PDF
• 可选深色/浅色主题

PDF 报告

方式一：HTML 转 PDF（推荐）

python3 scripts/report_renderer.py html {report_config.json} -o {输出目录} --theme professional
# 然后使用系统工具转换，或让用户在浏览器中打印为 PDF

方式二：直接生成 PDF（需 weasyprint）

python3 scripts/report_renderer.py pdf {report_config.json} -o {输出路径} --theme professional

Word 报告（.docx）

python3 scripts/report_renderer.py docx {report_config.json} -o {输出路径}

Word 报告特点：

• 使用标准样式，兼容 Microsoft Office 和 WPS
• 图表以高分辨率 PNG 嵌入
• 目录自动生成
• 页眉页脚包含公司名称和日期

5. 报告配置

所有格式共用相同的 JSON 配置结构：

{
  "title": "2025年度财务分析报告",
  "subtitle": "内部管理报告 · 机密",
  "metadata": {
    "period": "2025-01 至 2025-12",
    "author": "数据分析部门",
    "date": "2025-01-15",
    "version": "1.0"
  },
  "company": {
    "name": "XX有限公司",
    "logo": "assets/logo.png"
  },
  "sections": [
    {
      "title": "执行摘要",
      "type": "summary",
      "content": "本期实现营业收入 1,234 万元，同比增长 15.2%...",
      "highlights": [
        {"label": "营业收入", "value": "1,234万", "change": "+15.2%", "positive": true},
        {"label": "净利润", "value": "156万", "change": "+8.7%", "positive": true}
      ]
    },
    {
      "title": "核心指标",
      "type": "kpi-cards",
      "items": [
        {"label": "毛利率", "value": "42.3%", "target": "40%", "status": "达标"},
        {"label": "应收账款周转天数", "value": "45天", "target": "<60天", "status": "达标"}
      ]
    },
    {
      "title": "收入趋势分析",
      "type": "chart",
      "image": "charts/revenue_trend.png",
      "caption": "图1：2025年各月营业收入及同比增长率",
      "analysis": "Q3收入增速放缓，主要受..."
    },
    {
      "title": "成本结构",
      "type": "chart",
      "image": "charts/cost_structure.png",
      "caption": "图2：成本构成分析",
      "analysis": "原材料成本占比 38%，同比上升 2.1 个百分点..."
    },
    {
      "title": "风险与建议",
      "type": "advisory",
      "risks": [
        {"level": "高", "description": "应收账款增速高于收入增速，关注回款风险"},
        {"level": "中", "description": "原材料价格波动可能影响毛利率"}
      ],
      "recommendations": [
        "加强应收账款管理，缩短账期",
        "建立原材料价格对冲机制"
      ]
    }
  ],
  "appendix": [
    {"title": "数据来源说明", "content": "本报告数据来源于公司财务系统..."},
    {"title": "计算方法", "content": "同比增长率 = (本期 - 去年同期) / 去年同期 × 100%"}
  ]
}

详细的 section type 和配置选项见 references/report-config-spec.md。

6. 质量检查

渲染完成后，检查：

• [ ] 所有图表清晰可读，无乱码
• [ ] 数字格式统一（千分位分隔、小数位数）
• [ ] 同比/环比标注完整
• [ ] 页面布局无溢出、无截断
• [ ] 公司名称、日期等元信息正确
• [ ] 如有要求，确认敏感信息已脱敏

设计原则

1. 专业优先：商务配色、清晰层级、适当留白，拒绝花哨
2. 数据准确：所有数字必须与源数据一致，图表标注数据来源
3. 结论前置：执行摘要放在最前面，让读者 30 秒抓住重点
4. 一图胜千言：能用图表表达的，不用纯文字堆砌
5. 可复现：保存配置文件，下次更新数据只需替换数据源

依赖

• Python 3.8+
• 必需：pandas、matplotlib、jinja2
• 可选：weasyprint（PDF 直出）、python-docx（Word 输出）
• 运行前检查依赖：pip3 list | grep -E "pandas|matplotlib|jinja2"

与数据分析虾的协作

本 skill 专注渲染和排版，与 auto-data-analysis-claw（数据分析虾）形成上下游关系：

• 数据分析虾完成数据清洗、分析计算、产出结论
• 本 skill 接收分析结论，负责排版、图表生成、文件导出

两个 skill 可在同一个对话中串联使用，也可独立工作。