📊 Data Visualization Skill
🧩 功能说明
该 Skill 用于：
- 数据整理
- 数据分析
- 数据可视化（Markdown + HTML + Mermaid）
- 输出高质量报告（适配 Typora / Markor / PDF）
🚀 使用方式
输入：
- 原始数据（表格 / 文本 / JSON）
- 分析目标（可选）
- 和AI的聊天内容
输出：
- 标准化 Markdown 报告
- 含图表（Mermaid / 表格 / 卡片）
📌 输出特性
- 从 CSV/JSON 文件加载数据，或使用内置示例数据集
- 使用 matplotlib 生成专业图表（柱状图、折线图、散点图）
- 生成带样式的报告，包括：
- 蓝色主题配色（
#e3f2fd、#bbdefb、#2196f3） - 弹性卡片布局展示关键指标
- 带条纹行的样式化 HTML 表格
- 用于数据处理流程的 Mermaid 流程图
- 渐变总结框
- 输出内嵌 base64 图片的 Markdown（无需外部文件）
- 从 CSV/JSON 文件加载数据，或使用内置示例数据集
- 使用 matplotlib 生成专业图表（柱状图、折线图、散点图）
- 生成带样式的报告，包括：
- 蓝色主题配色（
#e3f2fd、#bbdefb、#2196f3） - 弹性卡片布局展示关键指标
- 带条纹行的样式化 HTML 表格
- 用于数据处理流程的 Mermaid 流程图
- 渐变总结框
- 输出内嵌 base64 图片的 Markdown（无需外部文件）
- 通过
config.yaml完全自定义
🎯 适用场景
- 市场调研
- 销售数据分析
- 食品行业分析（重点适配）
- 竞品对比
- 趋势预测
使用方法
- 将数据文件（CSV/JSON）放入目录，或在
config.yaml中修改数据源路径。 - 在
config.yaml中调整可视化参数（图表类型、列名、标题等）。 - 运行技能：
```bash
python run.py
4.生成的报告将保存为 output.md（可配置）。在 Typora 或 Markor 中打开即可查看带样式的可视化结果。
输出格式规则（严格遵循）
本技能生成的报告完全遵循以下格式要求：
- 全文包裹在
markdown ...（四个反引号）内，防止外层提前闭合。 - 所有 CSS 均写在
style属性中。 - 卡片布局：
display: flex、gap、border-radius、box-shadow。 - 表格表头背景色
#b3e5fc，行间使用border-bottom分隔。 - 渐变总结框：
linear-gradient(145deg, #bbdefb, #b2dfdb)。 - 标题和署名居中，并包含日期。
- 适当位置可包含 Mermaid 图表和任务列表。
依赖环境
- Python 3.8+
- pandas, matplotlib, pyyaml
- （可选）seaborn 用于高级图表
安装命令：
bash
pip install pandas matplotlib pyyaml
配置说明 (config.yaml)
| 参数 | 类型 | 描述 |
|---|---|---|
data_source |
string | CSV/JSON 文件路径（留空则使用示例数据） |
chart_type |
string | bar、line 或 scatter |
x_column |
string | X 轴列名 |
y_column |
string | Y 轴列名 |
title |
string | 报告标题 |
output_file |
string | 输出 Markdown 文件路径 |
include_mermaid |
boolean | 是否包含处理流程图 |
文件结构
skill.md– 本说明文档config.yaml– 用户设置run.py– 主执行脚本prompt.md– 含内联 CSS 的 HTML/Markdown 模板schema.json– 配置文件 JSON 校验 schema
示例
yaml
# config.yaml
data_source: "sales.csv"
chart_type: "bar"
x_column: "Month"
y_column: "Revenue"
title: "月度销售报告"
output_file: "sales_report.md"
include_mermaid: true
运行 python run.py 即可生成报告。
```
