用途:处理 Excel 工作簿(.xlsx),包括读取、创建、修改数据、公式、格式,以及用 pandas 做数据分析。适用于以 Excel 为输入或交付物的任务。
主要能力:用 openpyxl 读写现有 XLSX、做单元格或样式修改;用 pandas 做数据分析与转换;用 XlsxWriter 创建新工作簿(不能读取或修改现有文件)。新建工作簿可直接写入可编辑的值、样式和公式。
使用方式:优先遵循用户或 AGENTS.md 指定的环境或库;否则调用 load_workspace_dependencies 并用其 Python 可执行文件(内置 openpyxl 和 pandas),不要安装包或另找系统 Python。脚本、工作文件和输出放在任务工作区。修改现有文件时用 openpyxl.load_workbook("input.xlsx", data_only=False) 加载,改完保存为新文件,除非用户要求原地编辑。公式写入后不会自动计算,需用 CLI 的 recalculate 命令刷新缓存结果,例如 "<node>" "<cli>" recalculate --input report.xlsx --output recalculated.xlsx。交付前用共享检查器验证:<python> <skill-directory>/../scripts/check_office.py <workbook.xlsx> --out <checks.json>。
限制:openpyxl 和 XlsxWriter 不计算公式,data_only=True 返回的缓存值可能缺失或过期;重算不验证业务逻辑。不要将 .xls、.xlsb、加密或启用宏的文件改名为 .xlsx。keep_vba=True 可保留 XLSM 中的 VBA 内容,但不执行或编辑宏。视觉检查仅在任务涉及格式、布局、图表或显示问题时进行;若模型不接受图像或渲染失败,应报告视觉检查不可用,不要反复重试或改用其他渲染器。LibreOffice 操作使用内置二进制,除非用户明确要求不用。