技能包

xlsx:把电子表格当作主交付物来处理

适合在主要输入或输出是 .xlsx 等表格文件时使用,前提是直接导入预装的 openpyxl,写入公式而不是硬编码,并在读值前先重算。

官方来源 · xlsx

安装

write the script and import directly

适合谁

当电子表格是主要输入或输出时,使用这份 xlsx 说明。覆盖打开、读取、编辑或修复已有的 .xlsx、.xlsm、.xltx、.csv 或 .tsv。交付物必须是电子表格文件。

不要在主要交付物是 Word、HTML 报告、独立 Python 脚本、数据库管道或 Google Sheets API 集成时触发,即使中间也有表格数据。资料没有给出代理产品名单,不要理解成某一家软件独占。官方说明页是

https://raw.githubusercontent.com/anthropics/skills/main/skills/xlsx/SKILL.md

3 分钟完成第一次尝试

推荐路径:openpyxl、pandas 和 markitdown 都已预装,先不要 pip install,直接写脚本并导入。

前置:当前环境能直接 import 这三个库。低风险第一次尝试是只读查看,不要先写盘。对一份本地已有的表格文件导入 markitdown 做快速查看;若文件不存在,停在打开失败,不要新建未点名的样例表。

成功信号:导入成功,并且你能看到该文件的文本概览。这不是修复或覆盖。若还没有现成文件、且用户明确要求产出表格,再改用 openpyxl 创建,但写盘前先确认文件名和是否覆盖。

创建时记住:要用公式,不要写入 Python 算好的硬编码结果。资料示例是把单元格写成 =SUM(B2:B9) 这类公式,这样输入变化时工作表还能重算。

使用案例

案例一:新建或修改一份会重算的表。用预装的 openpyxl 写脚本,导入后把合计写成公式,例如 B10 使用 =SUM(B2:B9),而不是先在 Python 里加总再写入数字。完成标准是文件里是公式,输入改动后工作表能重算。摘要把 pandas 留给批量读写、markitdown 留给快速查看;本案例只覆盖公式写入。摘录没有给出完整样式 API,不要编造未出现的格式函数。

案例二:含公式的文件必须重算后再读值。资料写明:只要文件含公式,重算是强制步骤。openpyxl 把公式写成字符串,没有缓存值;在你重算之前,每个公式单元格读回来都是 None。这是可逆检查:先打开刚写完的文件读公式格,若得到 None,说明还没重算,停在这里,先完成重算再把读到的值当成结果。不要把 None 解释成合计为零。

使用边界

只在电子表格本身是主交付时使用。Word、HTML、独立脚本、数据库管道、Google Sheets API 即使含表也不走这条。三个库已预装,默认不要先 pip install。公式必须能随输入重算;写完后必须重算,否则读回 None。

不要把未出现的仓库路径写成安装命令。不要用硬编码数字冒充合计。写盘或覆盖原表前,先确认目标路径和副作用,再执行。超出这些已写明的文件类型、导入方式和重算要求,这份说明覆盖不到。