xlsx

技能简介

本技能用于处理电子表格文件（如 .xlsx、.xlsm、.xltx、.csv、.tsv），涵盖读取、编辑、修复、创建及格式转换等任务。当用户提到具体的表格文件并要求对其进行操作时，该技能将自动触发，最终交付物为电子表格文件。

使用场景

• 用户说“打开我下载文件夹里的 xlsx，帮我加一列合计”
• 需要读取或修复损坏的 .xlsx / .csv 文件（如清理错位表头、乱数据）
• 从头创建新电子表格，或从其他数据源生成表格文件
• 在表格格式之间转换（如 CSV 转 XLSX）
• 需要批量读取或输出表格数据

使用方法

该技能已预装 openpyxl、pandas、markitdown，无需先执行 pip install，直接编写脚本导入即可。若导入失败，再安装缺失的包。

任务	推荐工具
创建/编辑（含公式、格式）	openpyxl
批量数据读写	pandas（read_excel / to_excel）
快速查看表内容	markitdown file.xlsx

文件包含公式时，必须用以下命令重算：

python scripts/recalc.py output.xlsx [timeout_seconds]   # 默认 30 秒

重算结果会返回 JSON，包含 status、total_formulas、total_errors 等信息。若得到 error 键而非 status 键，说明没有完成重算。

注意事项

• 公式不可用硬编码。 用 sheet['B10'] = '=SUM(B2:B9)' 写入公式，而不是写入 Python 计算好的数值。
• 函数兼容性有限。 优先使用 SUMIFS、INDEX、MATCH、IFERROR 等早期函数；TEXTJOIN、CONCAT、IFS 等需加 _xlfn. 前缀；不要使用 XLOOKUP、SORT、FILTER、UNIQUE 等新函数，否则会报 #NAME?。
• 交付前必须验证。 确保无公式错误；若怀疑错误在修改前就存在，需用 data_only=True 加载原文件核实。
• 严格遵守用户的规格。 工作表名称、列标题、公式写法均按用户要求；所有假设和硬编码数字需在单元格注释或旁边注明来源。
• 编辑现有文件时，沿用原文件的样式和约定，只修改指定输入单元格，不要改动已有公式。