技能介绍

先说清楚痛点

用脚本改 Excel 的人多半踩过这几个坑：读进来的是 =TEXT(A1,"yyyymmdd") 这样的公式字符串，自己却当值处理，int() 一调直接炸；插入几列之后，公式里的引用全部错位；跑完发现数据对不上，原文件还已经被覆盖，无从回溯。大文件更糟——openpyxl 全量加载大约 1s/MB，没设好 timeout 就是等到超时；中途失败留下的损坏文件和临时目录堆在原地，下次运行接着踩。

这套方法怎么解决

excel-safe-workflow 定义的是一套可复用的五步标准流程，任何 Excel 结构性编辑任务都照此执行：

第零步：备份。任何写操作前先备份，文件名带时间戳，与源文件同目录。这是第一道防线，没有例外。
第一步：勘察。先看体量、估耗时、定 timeout，再扫描结构与数据类型。
第二步：规划。动笔前回答目标列、数据类型、公式列、多列操作顺序、耗时估算五个问题。
第三步：执行。加载、按序写入、输出进度、保存并清理。
第四步：验证。表头、抽样数据、验证清单逐项打勾。

双模式读取是最关键的一环

同一个文件必须用两种模式各读一次并对比结果：不带 data_only 时读到的是公式字符串，适合要改公式本身的场景；加 data_only=True 时读到的是计算结果，适合做数据分析和转换。只读一次就动手，是绝大多数翻车的起点。

多列操作从右到左

涉及多列插入或删除时，按列号从大到小处理，避免前面的插入让后续列号整体偏移。执行阶段还要输出进度，否则大文件处理时无法判断是卡死还是正常耗时。

验证清单

修改后需要逐项确认：新列位置正确、数据格式正确（如 yyyymmdd 文本）、相邻列未被意外改动、公式列引用未错乱、无遗漏行（空值需确认是源数据本身为空而非写入遗漏）。

适用边界

这套流程约束的是结构性编辑的纪律，不是某个具体功能的封装。它针对的是包含公式或体量较大的现有文件；纯新建、无公式的小文件可以按需要裁剪步骤。备份保留策略是同目录仅留最新 3 份，需要长期留档的场景得自己加外部归档。另外，失误恢复的原则是立即删除损坏产物、从备份重来，不要试图在损坏文件上修补。其他 Excel 技能可以在自己的 SKILL.md 开头声明依赖，直接引用这里的流程模板，不必重复描述细节。