Excel 表格使用指南

解决的核心问题

在协作处理财务模型、数据分析报表或自动化生成报告时，团队常常面临Excel文件格式不统一、公式错误频出、以及CSV文件在不同系统间交换时出现乱码等具体痛点。这些“最后一公里”的问题会导致数据更新失败、协作效率低下，甚至引发严重的计算错误。

技能如何工作：核心规范与关键步骤

该技能通过提供一套详尽的操作规范来解决上述问题，其核心能力体现在以下几个方面：

1. 格式化与公式构建标准

它定义了行业通用的视觉规范，以减少误解并提升模型的可维护性。例如：

• 颜色编码：使用蓝色文本（RGB: 0,0,255）标识用户可修改的硬编码输入，而所有公式与计算必须使用黑色文本（RGB: 0,0,0）。
• 数字格式：强制要求货币使用$#,##0格式，百分比默认使用0.0%，并将零值显示为-，负数用括号(123)表示。
• 公式防错：要求将所有假设（如增长率）放在独立单元格，并通过单元格引用而非直接写入数字（如使用=B5*(1+$B$6)而非=B5*1.05）来构建公式，从而保证模型可动态更新。

2. CSV编码处理规则

针对CSV文件在Windows Excel、macOS Numbers和命令行工具间的兼容性问题，技能给出了明确的决策树：

• 当文件主要供Excel（Windows或Mac） 使用时，必须使用utf-8-sig（带BOM的UTF-8）编码保存。
• 当文件用于macOS原生工具或脚本时，则使用普通utf-8编码。
• 这避免了常见的中文字符显示为乱码（如）的问题。

3. 文件创建与重算工作流

技能规范了使用openpyxl和pandas处理Excel文件的关键步骤：

1. 选择工具：pandas用于数据分析，openpyxl用于处理复杂格式与公式。
2. 始终使用公式：强调在创建或修改文件时，应写入Excel公式而非Python计算出的硬编码值。
3. 强制重算：使用提供的scripts/recalc.py脚本，通过LibreOffice对包含公式的文件进行重算并扫描所有#REF!、#DIV/0!等错误。
4. 错误修复：根据脚本返回的JSON错误报告进行定位和修复。

适用边界与注意点

此技能是一套规范指南，而非自动化工具。实施时需注意：

• 环境依赖：重算脚本依赖于LibreOffice的安装，它在首次运行时自动配置。
• 平台特定问题：utf-8-sig编码在macOS的Numbers应用中可能导致BOM字符显示异常，需根据目标用户选择合适编码。
• 工作流纪律：必须严格遵守“先使用openpyxl写入公式，再调用recalc.py重算”的流程，否则文件中的公式值将不会更新。
• 设计边界：规范主要针对金融模型、数据报表等结构化文件，对于纯文本或艺术性排版的Excel用途不直接适用。