report-generation

报告生成技能

何时使用

当用户要求生成报告、分析报告、可视化报告、趋势分析、统计报告等任何报告时。

⚠️ 约束（不可违反）

禁止写入本地文件
禁止调用上传工具（upload_html_report_to_minio 等）
HTML 必须用分隔符包裹后直接输出到对话中
此技能是指令文档，直接按流程执行，不要说"调用技能"然后停下

工作流程（5 步，必须全部完成）

第 1 步：理解需求

从用户诉求中提取：

报告类型：销售、用户、产品、运营、财务等
关键指标：总量、增长率、排名、占比等
分析维度：时间、地区、类别、产品等
时间范围：最近一周/月/年等

第 2 步：探索数据库 & 查询数据

sql_db_list_tables → 找到相关表
sql_db_schema → 查看列名和类型
sql_db_table_relationship → 查看表关系
sql_db_query → 执行查询获取数据

查询原则：

只查必要列，不用 SELECT *
使用表别名、适当的 JOIN 条件
合理使用聚合函数、GROUP BY、ORDER BY
默认 LIMIT 100

第 3 步：深度分析（⚠️ 必须执行，不可跳过）

查询到数据后，必须先分析再生成报告。以下 4 个分析维度至少完成 3 个：

A. 描述性分析 — What happened

计算核心指标：总量、均值、中位数、最大/最小值
计算增长率：同比（YoY）、环比（MoM）
计算占比：各分类在整体中的比例
检测异常值：偏离均值超过 2 倍标准差的数据

B. 趋势分析 — How is it changing

趋势方向：上升/下降/平稳/波动
变化速率：加速还是减速
拐点识别：趋势逆转的关键时间点
周期性模式：季节性、节假日效应

C. 归因分析 — Why did it happen（⚠️ 核心，必须完成）

维度下钻：哪个地区/产品/渠道对变化贡献最大？
贡献度量化：各维度对总体变化的贡献百分比
对比归因：表现优于/低于平均水平的类别及原因
结构变化：各维度占比随时间的迁移

D. 对比分析 — How does it compare

时间对比：同比、环比
分组对比：不同地区/产品/渠道间的差异
排名分析：Top N 和 Bottom N
帕累托分析：头部集中度（80/20 效应）

第 4 步：生成 HTML 报告

⚠️ 第 3 步的所有分析结果必须写入 HTML 报告中，不能只在思考过程中分析而不输出到报告里。

报告 HTML 的 <body> 必须按顺序包含以下 6 个区块（缺一不可）：

区块 HTML 结构内容要求

1 报告标题 <header>

报告名称 + 时间范围

2 KPI 统计卡片 <section class="kpi-cards">

3-5 个关键指标卡片，每个包含：指标名、数值、同比/环比变化（↑绿↓红）

3 可视化图表 <section class="charts">

至少 2 个 Chart.js 图表

4 详细数据表格 <section class="data-table">

完整数据列表，关键行高亮

5 深度分析与归因 <section class="deep-analysis">

⚠️ 必须包含，见下方详细结构

6 结论与建议 <section class="conclusions">

核心发现 + 可操作建议

图表类型选择：

时间趋势 → 折线图/面积图
类别对比 → 柱状图
占比分析 → 饼图/环形图
多指标对比 → 组合图（柱状图 + 折线图）
排名展示 → 水平柱状图

⚠️ 第 5 区块「深度分析与归因」HTML 结构（强制）：

<section class="deep-analysis"> <h2>深度分析与归因</h2>

<div class="analysis-block"> <h3>数据概览</h3> <p>总量/均值/中位数等核心指标描述，标注同比环比变化。</p>  </div>

<div class="analysis-block"> <h3>趋势分析</h3> <p>趋势方向、变化速率、拐点描述。</p>  </div>

<div class="analysis-block attribution"> <h3>归因分析</h3>  <table> <thead><tr><th>维度</th><th>贡献值</th><th>贡献占比</th><th>变化方向</th></tr></thead> <tbody> <tr><td>[维度A]</td><td>[+/-数值]</td><td>[XX%]</td><td>[↑/↓]</td></tr>  </tbody> </table> <p>核心驱动因素：[维度A] 贡献了整体增长的 XX%，主要原因是...</p> <p>主要拖累因素：[维度B] 导致下降 XX%，原因是...</p>  </div>

<div class="analysis-block"> <h3>对比分析</h3> <p>Top N / Bottom N 排名描述，帕累托效应描述。</p> </div>

<div class="risk-alert"> <h3>⚠️ 风险提示</h3> <ul> <li>[异常信号1：具体数字 + 影响说明]</li> <li>[异常信号2：具体数字 + 影响说明]</li> </ul> </div> </section>

第 6 区块「结论与建议」HTML 结构：

<section class="conclusions"> <h2>结论与建议</h2> <div class="findings"> <h3>核心发现</h3> <ol> <li>[发现1，必须带具体数字]</li> <li>[发现2，必须带具体数字]</li> <li>[发现3，必须带具体数字]</li> </ol> </div> <div class="recommendations"> <h3>建议</h3> <ul> <li><strong>短期：</strong>[具体可操作的建议]</li> <li><strong>中期：</strong>[具体可操作的建议]</li> <li><strong>长期：</strong>[具体可操作的建议]</li> </ul> </div> </section>

HTML 技术要求：

Chart.js via CDN：https://cdn.jsdelivr.net/npm/chart.js
Google Fonts：Inter（正文）+ Playfair Display（标题）
CSS 变量实现浅色/深色模式（prefers-color-scheme: dark ）
响应式设计，卡片布局，间距一致
配色专业（蓝色系为主），对比度 ≥ 4.5:1
不使用 emoji 作为图标（⚠️ 和 ↑↓ 在报告正文中允许使用）
.analysis-block 和 .risk-alert 使用卡片样式（圆角、阴影、内边距）
.attribution table 使用斑马纹样式，贡献占比列用进度条或色条可视化

第 5 步：输出报告

用分隔符包裹 HTML 直接输出：

根据查询结果，为您生成数据分析报告：

<!DOCTYPE html> <html lang="zh-CN"> <head>...</head> <body>...</body> </html>

报告已生成完毕，包含：

[图表1说明]
[图表2说明]
详细数据表格
分析结论与洞察

您可以点击「预览报告」查看，或点击「下载报告」保存到本地。

关键：

分隔符必须独占一行
HTML 必须完整（DOCTYPE + html + head + body）
查询数据后必须立即生成报告，不要中途停顿

常见报告模式速查

模式查询策略推荐图表

时间趋势 DATE_TRUNC + GROUP BY 月份折线图

类别对比 GROUP BY 类别 + ORDER BY 柱状图

Top N 排名 ORDER BY DESC LIMIT N 水平柱状图

占比分析 GROUP BY + 百分比计算饼图/环形图

增长率分析窗口函数 LAG() 折线图 + 数据标签

归因分解多维度 GROUP BY + 增量贡献瀑布图/堆叠柱状图

异常检测均值 ± 2σ 标记异常折线图 + 红色标注

帕累托分析累积占比计算组合图（柱状 + 累积线）

report-generation

Safety Notice

Copy this and send it to your AI assistant to learn

Source Transparency

Related Skills

ui-ux-pro-max

schema-exploration

query-writing

report-generation