yjz211/vivid-figures-skill

让 AI 用你的数据生成科研图表：108 个配方，鲜艳与稳重两种风格，多套配色，交付图片与源码。仅限个人非商业使用。

是什么

Vivid Figures 是一个 Agent Skill — 一组数据驱动的图表模板和配色方案，AI 助手可用来自动创建科学图表。该仓库包含：

143 个现成的图表「配方」（例如，脊柱图、热力图、3D 分组条形图、SHAP 重要性可视化等）
7 个配色方案包（每个包含 5–8 种颜色），存储在一个 JSON 文件中
Python 代码，能够读取配方、加载用户提供的 CSV/Excel/JSON 数据、选择合适的图表类型、渲染图表，并输出 PNG、PDF 和可复现的源代码脚本

该技能遵循 Agent Skills 开放规范，意味着它可以被直接集成到任何支持文件读取、Python 执行和图像显示的 AI 助手平台中。

用户提示 – 你告诉助手你想要什么，例如：

用 vivid-figures-skill 读取 results.csv，比较不同方法的得分分布。用珊瑚青绿配色。

数据解析 – Python 辅助工具读取 CSV/Excel 文件，推断列的含义，并与图表模板匹配。
模板选择 – 基于数据结构和用户意图，技能从 143 个配方卡片中选择一个（每张卡片包含 Markdown 描述、预览图像和完整源代码）。
渲染 – 关联的 Python 脚本运行，生成 PNG 用于快速预览，PDF 用于发表，以及完整的源代码（Matplotlib/Seaborn/Plotly 等）供后续编辑。
后处理 – 助手可根据指令调整图例、字体大小或移动元素，同时保留原始配色方案和设计意图。

丰富的图表配方库 – 覆盖基础图表（散点图、小提琴图、直方图）和高级可视化（3D 分组条形图、多 Y 轴梯度直方图、SHAP 依赖与贡献图、地形风格相关热力图）。
七套精心挑选的配色方案 – 每个配色方案是一个 JSON 文件；默认为 Olive-Apricot，但可通过简单自然语言命令切换任意配色。
开放的 Agent-Skill 格式 – SKILL.md 中包含元数据（YAML + Markdown），所有资源通过相对路径引用，使技能可在不同 AI 助手主机间轻松移植。
输出灵活性 – PNG 用于快速检查，PDF 用于 LaTeX/Word 插入，完整 Python 源代码可让用户后续复现或修改图表。
非商业、个人使用许可 – 该仓库对学术或个人项目免费，但未经书面许可禁止商业再分发。
自检机制 – 每个模板包含「保真度点」，助手可验证（如保持渐变、保留图层顺序），避免设计过度简化。

前置条件 – Python 3.10+，Git，Bash（Windows 上可使用 Git Bash）。可选：若想本地浏览 HTML 目录，需 Node.js 22+。
安装 – 参照 docs/INSTALL.md（克隆仓库，运行 pip install -r requirements.txt）。
加载到 AI 助手 – 将文件夹放置在助手期望的 Agent Skills 目录中，或使用主机特定的导入命令。
运行提示 – 如 README 所示，要求助手从你的数据文件生成图表。
查找结果 – 助手会创建一个 figures/ 目录，包含 PNG、PDF 和 Python 脚本。

Vivid Figures 是一个 即开即用、AI 驱动的图表生成技能，让语言模型仅用最少提示即可将原始数据转化为出版级图表。它集成了丰富的预测试模板、配色方案和可复现的 Python 流水线，全部遵循开放的 Agent Skills 规范。