如何用 Agent Skills 搭建数据可视化报表:从 Excel 图表到 PPT 的完整指南
【免费下载链接】skillsPublic repository for Agent Skills项目地址: https://gitcode.com/GitHub_Trending/skills3/skills
做报表最累的不是算数,而是反复折腾格式:Excel 公式一改就错、PPT 图表配色难看、Word 排版又得重做一遍。skills仓库(Anthropic 开源的 Agent Skills 集合)解决的就是这件事——它用一组"技能包"教 AI 按专业流程完成数据可视化和报表任务:建带公式的电子表格、生成原生 PPT 图表、套上统一主题、输出 Word/PDF 报表。无论你是想让 AI 帮你出报表的新手,还是想把自己团队的工作流沉淀成可复用技能的人,这个仓库都值得一看。
📦 它到底能帮你做什么
仓库里每个技能都是一个独立文件夹,靠一份SKILL.md(技能的说明书)告诉 AI 该怎么做。和数据报表相关的核心能力如下:
| 技能 | 能力 | 说明文档 |
|---|---|---|
xlsx | 创建/编辑 Excel,写公式、重算、清洗脏数据 | skills/xlsx/SKILL.md |
pptx | 从零生成 PPT,含原生可编辑图表 | skills/pptx/SKILL.md |
docx | 生成/编辑 Word 报告,目录、页眉、修订 | skills/docx/SKILL.md |
pdf | 合并拆分 PDF、填表单、提取文字 | skills/pdf/SKILL.md |
theme-factory | 10 套配色字体主题,一键统一视觉风格 | skills/theme-factory/SKILL.md |
skill-creator | 教你写自己的技能,并带评测跑分流程 | skills/skill-creator/SKILL.md |
注意一点:docx、pptx、xlsx、pdf这几个是"源码可见"而非完全开源,其余技能为 Apache 2.0 协议,引用前看一下各目录下的LICENSE.txt即可。
🚀 跟着做一遍:四步出一套带图表的报表
第 0 步,拿到仓库。克隆下来看看结构:
git clone https://gitcode.com/GitHub_Trending/skills3/skills克隆完你会看到skills/(技能集)、spec/(技能规范)、template/(技能模板)三大块。
第 1 步,让 AI 生成电子表格。在 Claude Code 里安装技能包后,直接说"用 xlsx 技能建一个季度销售表"。技能内部用openpyxl(一个读写 Excel 的 Python 库)写文件,批量数据则交给pandas。
第 2 步,强制重算公式。这是最容易漏的一步——openpyxl写进去的公式默认没有计算结果:
python scripts/recalc.py output.xlsx一条命令,LibreOffice 把所有公式算一遍并回写文件,返回 JSON 告诉你有没有报错单元格(口语版说明:公式"算没算出来"它替你把了关)。
第 3 步,生成 PPT 并保留原生图表。用pptxgenjs(一个 Node.js 的 PPT 生成库)写脚本,关键点是用addChart()画图表——这样图表在 PowerPoint 里还能双击改数据,而不是一张死图片。
第 4 步,套主题 + 校验。从 skills/theme-factory/themes/ 挑一套配色(比如midnight-galaxy.md),再用scripts/office/validate.py校验文件结构是否合规,最后把 PPT 转成图片逐页检查有没有文字溢出:
python scripts/office/soffice.py --headless --convert-to pdf output.pptx这行命令借助 LibreOffice 把 PPT 转成 PDF,方便截图核对效果。
🔍 关键模块拆解
1. 公式重算器recalc.py(skills/xlsx/scripts/recalc.py) 整个 xlsx 技能的心脏。它调起 LibreOffice 重算全部公式,输出status、total_errors等 JSON 字段。有个容易踩的坑:退出码为 0 不等于文件干净,errors_found状态也返回 0,所以必须看 JSON 内容。另外它"只证明公式能算,不证明算得对"——建议先写两三个公式验证取值,再铺开整张表。
2. 文件校验器validate.py(skills/pptx/scripts/office/validate.py) 基于 OOXML 的 XSD 校验(XSD 可以理解成文件结构的"体检标准",schema 文件在 skills/pptx/scripts/office/schemas/)。图表定义就来自其中的dml-chart.xsd,覆盖了CT_LineChart、CT_BarChart、CT_PieChart这些图表类型。它的价值在于:能抓出"其他工具都放行、但 PowerPoint 直接拒绝打开"的坏图表,而且每个失败都会附上修法。
3. 主题库themes/(skills/theme-factory/themes/) 10 个 markdown 主题文件,每个定义一套色板(带 hex 色值)+ 标题/正文字体配对,比如"午夜银河"适合深色科技风、"现代简约"走灰阶路线。目录里还有一本theme-showcase.pdf,把所有主题排成一本"样本册",选起来像挑色卡一样直观。
🎯 真实场景怎么选
季度经营报表:xlsx建数据表(公式用SUMIFS/INDEX/MATCH这类老式函数,兼容性最好),recalc.py重算,再让docx技能把结论写成 Word 报告。收益:数据更新后报表自动跟着变,不用手抄数字。
融资/汇报 PPT:pptx技能生成幻灯片 +theme-factory套主题。PPT 技能文档里附了 10 组"按场景选色"的调色板(如深蓝执行风1E2761+ 冰蓝CADCFC),还强调每页都要有视觉元素——大数字、图标、图表,别做纯文字页。
PDF 表单批量填报:pdf技能配合 skills/pdf/forms.md 和scripts/下的表单脚本(如fill_fillable_fields.py),把发票、审批单这类可填写 PDF 自动化处理掉。
⚠️ 少踩坑的经验
- Excel 公式别用新函数。
XLOOKUP、FILTER、UNIQUE这类在重算环境(LibreOffice)里算不出来;2007 年之后的 6 个函数要加_xlfn.前缀,否则文件里会烧进#NAME?错误。 data_only=True是破坏性操作。用它读出的工作簿没有公式了,一旦保存,公式全变成死数字。读写"既要公式又要值"的表,得加载两遍。- PPT 配色写法有雷区。
pptxgenjs里颜色必须写成"FF0000",带#号或 8 位带透明度的写法会直接损坏文件;堆叠柱状图的数据标签位置也不能用outEnd,同样会导致文件打不开。 - 模板派生的 PPT,校验时一定带
--original。模板本身可能就有不符合 XSD 的部件,不带基线对比会把模板的"旧账"算到你头上。 - 环境依赖先装齐:LibreOffice(重算和格式转换)、Poppler 的
pdftoppm(PDF 转图片做视觉检查)、markitdown(快速读取文档文字)。 - 进阶方向:想沉淀自己的流程,用
skill-creator的"写技能 → 跑测试提示词 → 评测 → 改写"循环迭代,它的评测脚本在 skills/skill-creator/scripts/。新技能可以从 template/SKILL.md 这份三行模板起步,只需填name和description两个字段。
📚 资源清单
- 项目总览与安装方式:README.md
- xlsx 技能(含公式规范与重算流程):skills/xlsx/SKILL.md
- pptx 技能(含图表与设计规范):skills/pptx/SKILL.md
- PDF 表单处理专题:skills/pdf/forms.md
- 主题样本册:skills/theme-factory/theme-showcase.pdf
- 技能规范说明:spec/agent-skills-spec.md
一句话总结:把"出报表"这件脏活拆成表格、图表、主题、校验四段流水线,skills仓库就是这条流水线的标准件库——照着走一遍,你拿到的是一套能复用的报表生产流程。
【免费下载链接】skillsPublic repository for Agent Skills项目地址: https://gitcode.com/GitHub_Trending/skills3/skills
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考