Skip to content
cccskills
FreePublished on GitHub

data-report

把 CSV、Excel 或 JSON 数据生成包含 KPI、图表和洞察的完整可视化报告页。当用户说“数据报告、CSV/Excel 转报告、做 KPI 看板、生成可视化报告页”时使用。单张图表用 chart-visualization;信息图或 GIF 动画图表用 infographic。

The English summary is being prepared. Showing the original description.

Works withExcel
See how to install

Files included (3)

  • SKILL.md3.4 KB
  • EASEL-META.md1.5 KB
  • scripts/report.py21.7 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

数据可视化报告

你是一名数据可视化专家。把用户提供的 CSV/Excel/JSON 数据,转成一份自包含的 HTML 可视化报告(KPI 卡片 + 图表 + 数据洞察 + 数据表)。

数据读取、聚合、出图、HTML 组装都由 scripts/report.py 确定性完成, 你只负责"写洞察文字"这一需要理解的环节,不要手算聚合、手拼图表。

与其他图表 SKILL 的区别

三者都能"生成图表",但机制与产物不同,按需求路由:

  • data-report(本 SKILL) = 输入 CSV/Excel/JSON,产出整页可视化报告(KPI 卡 + 多图 + 洞察 + 表格)。要一份完整报告页时用它。
  • chart-visualization = 调 AntV 远程 API,产出单张静态图片 URL(25+ 类型)。只要一张标准统计图、直接拿图片链接时用它。
  • infographic = 本地 JS 渲染,产出信息图 / GIF 动画图表。要结构化信息图或带动画的 GIF/MP4 时用它。

输入

  • 数据文件:.csv / .json / .xlsx(Excel 需环境有 openpyxl,缺失时脚本会提示)
  • 可选:报告标题、想突出的 KPI 列名

输出

  • 一个自包含 HTML 报告文件(图表以 base64 内嵌,可离线打开),写入 outputs/
  • 可选:把 HTML 渲染成一张长图用于社媒分享

执行步骤

1. 读数据概览(供你写洞察)

python skills/builtin/data-report/scripts/report.py analyze <数据文件>

返回 JSON:行列数、每列类型与缺失、数值列的 min/max/mean/median/sum/std、 每个类别列的 Top 5。据此判断数据讲了什么,为第 3 步准备洞察文字。

2. 生成报告 HTML

python skills/builtin/data-report/scripts/report.py report <数据文件> \
  -o outputs/主题名/report.html \
  --title "报告标题" \
  --kpi 列名1 列名2         # 可选,不给则自动挑数值列

脚本自动:算 KPI(数值列汇总)、自动选型出 2-4 张图(时间序列→折线、 类别→柱状、占比→饼图)、拼成含 KPI 卡 + 内嵌图 + 数据表的整页 HTML。 matplotlib 用 Agg 后端并已配好中文字体,不会乱码。

3. 补写洞察文字(可选但推荐)

基于第 1 步的概览,在生成的 HTML 里补 3-5 条洞察(emoji 开头、像产品周报: 趋势、异常、对比、行动建议)。用 Edit 在报告的洞察区插入即可——数据都是 真实的,不要捏造数字,只做解读。

4. 渲染成长图分享(可选)

python skills/shared/scripts/render_card.py \
  --html outputs/主题名/report.html \
  --out outputs/主题名/report.png \
  --full-page --width 1080

Profile 感知

  • 有 Profile:从 style.md 读品牌主色,用 Edit 改 HTML 里 --main 变量统一配色。
  • 无 Profile:用脚本默认专业配色。

要点

  • 必须用脚本解析真实数据,KPI 与图表由脚本从数据算出,不要手写数值。
  • 洞察是你唯一"创作"的部分,其余都走脚本保证确定性。
  • 无数值列时脚本仍出数据表(会打印 WARN),报告依然可用。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

通用 AI 生图:文生图 / 图生图 / 图像变体。当用户说 AI 生图、AI 画图、文生图、图生图、生成图片、生成配图、图像生成、AI 出图、AI 作图、换图、改图、图像编辑、给我画一张、生成一张图 时使用。支持 OpenAI 兼容 API 与 apimart 异步 API,用户自备 API key。

The English summary is being prepared. Showing the original description.

ZJU-REAL/Easel3.9KUpdated Oct 18, 2026

AI 音乐 / BGM 生成:给短视频、社媒内容生成原创背景音乐 / 配乐 / 纯音乐。通过可插拔 provider(阿里 DashScope / Suno 类第三方 API)文生音乐,异步提交→轮询→下载,产物可再裁剪/归一化或加到视频。当用户说“AI 音乐”“AI 配乐”“生成 BGM”“背景音乐”“原创音乐”“AI 作曲”“纯音乐”“给视频配乐”“做首曲子”时使用。与 tts-voiceover 的区别:tts-voiceover 生成人声口播/旁白,ai-music 生成背景音乐/配乐(无人声或带演唱)。

The English summary is being prepared. Showing the original description.

ZJU-REAL/Easel3.9KUpdated Oct 18, 2026

AI 视频生成:文生视频 / 图生视频 / 数字人首帧驱动。通过可插拔 provider(通义万相 Wan / 火山 Seedance / 快手可灵 / OpenAI 兼容)异步生成视频,用户自备 API key。当用户说 AI 视频生成、文生视频、图生视频、AI 生成视频、AI 短视频、让图片动起来、数字人视频、生成一段视频 时使用。与 video-strategy(选型/策略)、video-editing(剪辑处理)、clipify(切片)区别:本 SKILL 是从 0 用 AI 生成新视频。

The English summary is being prepared. Showing the original description.

ZJU-REAL/Easel3.9KUpdated Oct 18, 2026

outputs/ 目录下的产物管理:按日期/平台/类型归档、打标签、搜索历史内容、生成素材清单。 当用户说"整理素材"、"归档"、"找之前的内容"、"搜索历史"、"素材管理"、 "outputs 整理"、"之前做的"时使用。 与其他 produce 层 SKILL 的区别:produce 层负责生成内容, asset-manager 负责生成后的产物管理(归档、检索、标签)。

The English summary is being prepared. Showing the original description.

ZJU-REAL/Easel3.9KUpdated Oct 18, 2026

音频降噪:去除录音中的背景噪声、电流声、风噪、嗡嗡声,基于 ffmpeg 滤镜链(afftdn/highpass/lowpass)。 当用户说"降噪""去噪""去杂音""消除背景噪声""电流声""风噪""录音有杂音""音频降噪"时使用。 和 audio-editing 的区别:audio-editing 做剪辑/转码/音量等通用音频操作(内置 denoise 兜底),本 SKILL 专做降噪调参。

The English summary is being prepared. Showing the original description.

ZJU-REAL/Easel3.9KUpdated Oct 18, 2026

通用音频处理:音频剪辑/裁剪、格式转码(mp3/wav/m4a/aac)、音量归一化、从视频提取音轨、多段拼接、淡入淡出、变速(保音高)。当用户说“剪音频”“裁一段”“转成 mp3”“调音量/响度”“提取音轨/扒音频”“拼接音频”“淡入淡出”“加速/减速音频”“变速不变调”时使用。与 audio-denoise 的区别:audio-denoise 专做降噪,audio-editing 做除降噪外的通用音频操作(也内置 denoise 作为兜底)。

The English summary is being prepared. Showing the original description.

ZJU-REAL/Easel3.9KUpdated Oct 18, 2026

See all skills by ZJU-REAL

Report a problem with this skill