xlsx

XLSX 技能

用途

提供创建、读取、修改和自动化 Excel 电子表格工作流方面的专业能力。专注于使用 ExcelJS、SheetJS、pandas 和 openpyxl 进行程序化电子表格处理，以实现数据处理、报告生成和自动化。

适用场景

• 以编程方式创建 Excel 报告
• 读取和解析 XLSX 文件
• 在保留格式的同时修改现有电子表格
• 自动化重复的 Excel 任务
• 在 CSV 和 XLSX 格式之间转换
• 使用公式构建 Excel 模板
• 从复杂电子表格中提取数据
• 生成格式化的财务或数据报告

快速开始

在以下情况下调用此技能：

• 以编程方式创建 Excel 报告
• 读取和解析 XLSX 文件
• 在保留格式的同时修改现有电子表格
• 自动化重复的 Excel 任务
• 在 CSV 和 XLSX 格式之间转换

以下情况请勿调用：

• 创建 Google Sheets → 使用不同的 API
• 构建 Excel 加载项 → 使用适当的 .NET/JS 技能
• 不需要输出 Excel 的数据分析 → 使用 data-analyst
• 仅执行 CSV 操作 → 使用 csv-data-wrangler

决策框架

Excel Task?
├── Node.js Environment → ExcelJS (full-featured) or SheetJS (parsing)
├── Python Environment → openpyxl (Excel) or pandas (data + Excel)
├── Heavy Data Processing → pandas with openpyxl engine
├── Complex Formatting → ExcelJS or openpyxl
├── Template-Based → Fill existing templates with data
└── Large Files → Streaming readers (ExcelJS streaming, pandas chunks)

核心工作流

1. 生成 Excel 报告（Node.js）

1. 初始化 ExcelJS 工作簿
2. 创建名称适当的工作表
3. 定义列的标题和宽度
4. 添加源数据行
5. 应用样式（字体、边框、填充）
6. 添加计算公式
7. 设置打印区域和页面布局
8. 写入文件缓冲区或流

2. 提取电子表格数据（Python）

1. 使用 openpyxl 或 pandas 加载工作簿
2. 确定数据范围和标题
3. 处理合并单元格和格式
4. 将数据提取为结构化格式
5. 验证并清理提取的数据
6. 根据需要处理多个工作表
7. 转换为所需的输出格式

3. 基于模板生成报告

1. 创建包含格式和公式的主模板
2. 加载模板工作簿
3. 确定数据插入位置
4. 在保留公式的同时插入数据
5. 更新日期或引用单元格
6. 根据需要重新计算公式
7. 另存为新文件（保留模板）

最佳实践

• 对大型文件使用流式模式以管理内存
• 修改文件时保留现有样式
• 写入单元格前验证数据类型
• 明确处理合并单元格
• 使用命名区域以便维护
• 使用实际的 Excel 应用程序进行测试，而不仅仅依赖库

反模式

• 将超大文件全部加载到内存中 → 使用流式读取器
• 硬编码单元格引用 → 使用命名区域或动态查找
• 忽略数据类型 → 明确设置数字、日期和文本类型
• 覆盖公式 → 写入前检查单元格类型
• 缺少错误处理 → 处理损坏或受密码保护的文件