excel-report-generator
Automatically generate Excel reports from data sources including CSV, databases, or Python data structures. Supports data analysis reports, business reports, data export, and template-based report generation using pandas and openpyxl. Activate when users mention Excel, spreadsheet, report generation
By wwwzhouhui · 382 installs
npx skills add wwwzhouhui/skills_collection --skill excel-report-generator
Source repository · Upstream listing
Excel Report Generator
自动化 Excel 报表生成工具,支持从多种数据源生成专业的 Excel 报告。
功能概述
这个 Skill 可以帮助你:
📊 从 CSV、数据库或 Python 数据结构生成 Excel 报表
📈 创建包含图表、格式化和公式的数据分析报告
📋 基于模板填充数据生成业务报告
💾 将系统数据批量导出为格式化的 Excel 文件
🎨 应用专业的样式、颜色和条件格式
核心技术栈
pandas : 数据处理和分析
openpyxl : Excel 文件读写和格式化
xlsxwriter : 高级图表和格式支持(可选)
使用场景
1. 数据分析报表
从原始数据生成包含统计分析、透视表和可视化图表的综合报告。
示例请求 :
"帮我从这个 CSV 生成销售分析报表"
"创建一个包含月度趋势图的数据分析 Excel"
"生成带有统计汇总的财务报表"
2. 业务报告
定期生成标准化的业务报告,如销售报告、KPI 仪表板等。
示例请求 :
"生成本月的销售业绩报告"
"创建 KPI 跟踪报表"
"导出季度业务总结 Excel"
3. 数据导出
将数据库查询结果或系统数据导出为格式化的 Excel 文件。
示例请求 :
"把用户数据导出到 Excel"
"将数据库查询结果保存为 Excel 文件"
"导出多个工作表的数据集"
4. 模板填充
基于预定义的 Excel 模板填充动态数据。
示例请求 :
"使用这个模板生成报告"
"填充 Excel 模板中的数据"
"批量生成基于模板的发票"
使用方法
基本工作流程
1. 准备数据源 : CSV 文件、pandas DataFrame、数据库连接或 Python 字典
2. 定义报表需求 : 描述所需的格式、图表、样式
3. 生成报表 : 自动创建格式化的 Excel 文件
4. 验证输出 : 检查生成的文件是否符合要求
命令示例
从 CSV 生成报表 :
从 DataFrame 生成报表 :
使用模板 :
实现指南
当用户请求生成 Excel 报表时,遵循以下步骤:
Step 1: 数据准备
Step 2: 数据处理
Step 3: 创建 Excel 文件
Step 4: 格式化和样式
Step 5: 添加图表(可选)
高级功能
条件格式
数据验证
公式应用
最佳实践
1. 性能优化
对于大数据集( 10万行),使用 openpyxl 的 write only 模式
分批处理数据,避免内存溢出
使用 xlsxwriter 引擎处理复杂图表和格式
2. 错误处理
3. 文件命名规范
4. 数据验证
5. 模板管理
将常用模板存放在 ~/.claude/skills/excel report generator/templates/ 目录
使用相对路径引用: templates/monthly report.xlsx
保持模板简洁,只包含结构和样式,不包含数据
快速参考
常用代码片段
查看 examples/quick reference.py 获取常用代码片段,包括:
基本 Excel 创建
多工作表管理
样式和格式化
图表创建
条件格式
公式应用
示例文件
examples/basic report.py 基础报表生成示例
examples/advanced report.py 高级功能示例
examples/template fill.py 模板填充示例
templates/business report.xlsx 业务报告模板
templates/data analysis.xlsx 数据分析模板
依赖安装
确保已安装必需的 Python 包:
可选依赖:
故障排查
常见问题
Q: 生成的 Excel 文件无法打开
A: 确保使用 .xlsx 扩展名,检查文件权限,验证数据中没有非法字符
Q: 图表不显示
A: 检查数据引用范围是否正确,确保数据类型为数值型
Q: 中文乱码
A: 使用 encoding='utf 8 sig' 读取 CSV,或在 Excel 中使用 UTF 8 编码
Q: 大文件生成很慢
A: 使用 write only=True 模式,减少格式化操作,分批写入数据
相关资源
[pandas 官方文档](https://pandas.pydata.org/docs/)
[openpyxl 官方文档](https://openpyxl.readthedocs.io/)
[xlsxwriter 官方文档](https://xlsxwriter.readthedocs.io/)
查看 REFERENCE.md 获取详细 API 参考
版本历史
v1.0.0 (2025 01 12) 初始版本,支持基础报表生成和模板填充