MarcelLeon XLSX 创建、编辑与分析
| 任务 | 推荐工具 |
|---|---|
| 公式、样式、结构 | openpyxl |
| 批量数据读写 | pandas |
| 快速浏览内容 | markitdown file.xlsx |
| 同时读取公式和值 | 分别用默认模式和 data_only=True 加载 |
openpyxl、pandas、markitdown 通常已预装。先直接使用，只有导入失败时才安装。脚本路径均相对于本 Skill 目录。
中文场景 few-shot
输入：“下载目录里的销售台账.xlsx 帮我补毛利率、按区域汇总，再做一张趋势图。”
**执行：**先识别原表字段、输入单元格和既有样式；用公式生成毛利率，用汇总表和原生图表呈现趋势；回算后检查公式错误和关键数字。
输入：“把这份错位的 CSV 整成下周继续填报的运营模板。”
**执行：**用 pandas 纠正表头和脏行，输出中文列名清晰的 .xlsx；添加“可编辑区域”说明和一行真实格式示例，但不在已有业务表中擅自插入示例数据。
每个交付物都要满足
- 用户或既有模板的字段名、sheet 名、格式和公式约定优先。
- 新建中文表格时选用目标环境可用的专业中文字体；已有表格必须继承原字体。
- 公式必须写入 Excel，不把 Python 计算结果硬编码成静态值。
- 所有假设和硬编码数字应在可见位置说明来源；用户提供的数据明确标注“来源：用户提供”。
- 用户要继续填写的空模板需要短图例和一行格式示例；编辑已有文件时不要擅自添加。
- 交付前
recalc.py必须达到零公式错误。
通用工作流
- 快速浏览所有 sheet、表头、合并单元格、公式和输入样式。
- 明确哪些是输入、公式、跨表引用和外部链接。
- 先写 2–3 个代表性公式并核对引用，再批量填充。
- 保存后执行回算。
- 检查公式正确性、格式、图表范围和中文显示。
公式回算
openpyxl 只写公式字符串，不产生缓存值。含公式文件必须运行：
python scripts/recalc.py output.xlsx
脚本会原地改写工作簿，并输出 JSON：
status: success：公式已回算且没有已识别错误。status: errors_found：进程仍可能退出 0，必须读取total_errors和error_summary。- 出现
error字段而不是status：没有完成回算。
绿色回算只证明公式能求值，不证明业务引用正确。抽查至少 2–3 个关键公式的行列和边界。
公式兼容性
优先使用 SUMIFS、INDEX、MATCH、IFERROR、SUMPRODUCT 等兼容函数。
以下函数需要 _xlfn. 前缀：TEXTJOIN、CONCAT、IFS、SWITCH、MAXIFS、MINIFS。
不要使用当前校验链无法可靠回算的动态数组函数：
XLOOKUPXMATCHSORTFILTERUNIQUESEQUENCE
查找使用 INDEX/MATCH，排序、筛选和去重在 Python 中完成后再写入单元格。
openpyxl 高风险点
- 同时拿公式和值需要加载两次；一次加载无法兼得。
data_only=True的工作簿不能保存，否则公式会被静态值替换。- 刚由 openpyxl 写出的公式，用
data_only=True读取通常是None；先回算。 - 合并单元格只能写左上角锚点。
.xlsm必须使用keep_vba=True，否则宏会丢失。- 含空格的 sheet 名在公式中必须加单引号，如
='参数 输入'!$B$5。 - 修改现有文件时先识别其输入颜色/填充，只写指定区域，不覆盖原公式。
外部链接
公式如 ='[1]Returns Analysis'!$B$2 指向外部文件。openpyxl 保存后可能丢失原缓存值，LibreOffice 无法解析时会写入 #NAME? 并删除链接。
遇到外部链接时：
- 在修改前读取并保存原缓存值。
- 不要直接覆盖原文件。
- 明确说明外部依赖是否可用。
- 只有用户接受链接丢失风险时才使用
recalc.py --force。
财务模型默认约定
既有模板或用户要求优先；否则：
- 蓝字：硬编码输入和情景变量。
- 黑字：公式。
- 绿字：同工作簿跨表引用。
- 红字：外部文件引用。
- 黄底：关键假设或待填写单元格。
- 百分比存为小数，
0.15显示为15.0%。 - 负数用括号，零显示为
-，倍数显示0.0x。 - 每个假设放在独立单元格并由公式引用，不把
1.05写死在公式里。
最终验收
python scripts/recalc.py output.xlsx
随后检查：
total_errors == 0- 关键公式引用正确
- sheet 名、列名、日期和数值格式符合用户要求
- 图表数据范围和图例正确
- 中文字符、列宽、冻结窗格、筛选和打印区域可用
依赖
openpyxl · pandas · markitdown · LibreOffice