用途:处理 Excel/表格文件(.xlsx、.xlsm、.csv、.tsv),覆盖读取分析、创建、编辑、修复公式和校验五类任务。直接处理请求,不派生子代理,始终写出用户要求的输出文件。
主要能力与任务路由:READ 用 xlsx_reader.py 加 pandas 分析现有数据,不修改源文件;CREATE 从 XML 模板新建 xlsx;EDIT 通过 XML 解包→编辑→打包修改现有文件;FIX 修复现有 xlsx 中损坏的公式;VALIDATE 用 formula_check.py 检查公式。
使用方式:读取先运行 python3 SKILL_DIR/scripts/xlsx_reader.py input.xlsx 做结构发现,再用 pandas 分析。创建时复制 templates/minimal_xlsx/ 并直接编辑 XML,用 xlsx_pack.py 打包,派生值必须写成 Excel 公式而非硬编码数字。编辑时先解包:python3 SKILL_DIR/scripts/xlsx_unpack.py input.xlsx /tmp/xlsx_work/,编辑后用 python3 SKILL_DIR/scripts/xlsx_pack.py /tmp/xlsx_work/ output.xlsx 重新打包。辅助脚本包括 xlsx_add_column.py、xlsx_insert_row.py、xlsx_shift_rows.py、formula_check.py。
关键规则:编辑任务绝不新建 Workbook,必须加载原文件;输出须保留与输入相同的 sheet 名称和数据,只改任务指定单元格;保存后需用 xlsx_reader.py 或 pandas 验证原 sheet 名与样本数据;不要对现有文件用 openpyxl 往返处理,以免破坏 VBA、透视表和迷你图。公式优先,所有计算单元格用 Excel 公式。财务颜色标准:硬编码输入蓝色 0000FF,公式结果黑色 000000,跨表引用公式绿色 00B050。交付前用 formula_check.py 校验,退出码 0 表示安全。
限制:资料未提供收费、价格、平台支持范围等信息;动态重算需 libreoffice_recalc.py 且仅在可用时使用。