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) 初始版本,支持基础报表生成和模板填充