xlsx · 表格文件创建与编辑

读、写、修 Excel 表格:新建表格、批量数据处理、公式计算、格式美化、数据清洗,以及表格格式间转换。
openpyxl 负责公式与格式、pandas 负责批量数据、markitdown 快速预览。输出硬性标准:专业字体、用公式而非手算结果、零公式错误(recalc 校验通过)、遵循用户规格字面要求、假设与硬编码数字必须注明来源。财务模型有配色与数字格式规范。
调用示例:在聊天框中说"帮我做一张带公式的预算表"。
产品详解
定位
xlsx 是表格文件的创建、编辑与分析工具:凡以 spreadsheet 为主要输入或输出的任务都走它。它交付的是表格文件本身,不是报告或脚本。
核心能力
- 创建与编辑:openpyxl 写公式/格式(
=SUM(B2:B9)而非手算结果);pandas 批量数据进出。 - 快速预览:markitdown 按 sheet 快速浏览(无单元格坐标,不用于规划编辑)。
- 模型读取:读公式与值需两次 load_workbook(data_only 两种模式各一遍)。
- 强制重算:凡含公式的文件必须跑
recalc.py(LibreOffice 实算);errors_found为零才可交付。 - 公式选型:优先 Excel-2007 时代函数(SUMIFS/INDEX/MATCH/IFERROR);六个新函数需
_xlfn.前缀;禁用 XLOOKUP/SORT/FILTER/UNIQUE/SEQUENCE(运行时 LibreOffice 无法求值)。 - 财务模型规范:配色(蓝=硬编码输入、黑=公式、绿=跨表引用、红=跨文件、黄底=关键假设)、数字格式(货币/百分比存小数/倍数/年份文本化)。
- 结构纪律:每个假设独占命名单元格并被公式引用;整行公式保持一致;分母防零。
- 规格字面遵循:sheet 名、列名、用户指定的公式一字不差;重设计不算完成。
- 假设标注:每个假设与硬编码数字必须在读者看得见的地方注明来源(单元格注释或相邻单元格)。
工作流程
- 确认需求:新建/编辑/清洗/转换;读取现有文件时先用 markitdown 预览
- 写脚本:openpyxl 公式 + pandas 批量数据
- 跑
recalc.py重算校验;报错则修复再跑 - 先写 2-3 个公式验证取值正确,再铺开整表(防整表错位)
- 交付表格文件
输入与输出
| 输入 | 必填 | 说明 |
|---|---|---|
| 表格文件/需求 | 是 | 现有 .xlsx/.xlsm/.xltx/.csv/.tsv,或新建需求描述 |
输出:处理后的表格文件(公式已重算验证)。
与相邻 skill 的区别
| skill | 分工 |
|---|---|
| xlsx(本) | 交付物是表格文件 |
| 数据报告类 | 交付物是报告/HTML(表格只是中间数据) |
适用场景
- 新建带公式的预算表/模型表
- 现有表格的列增减、公式计算、格式美化、图表
- 混乱表格数据的清洗与结构化
- 表格格式间转换(csv/tsv/xlsx)
使用前准备
- openpyxl / pandas / markitdown 已预装,无需 pip;LibreOffice 用于公式重算。
- 交付红线:recalc 报
errors_found就不能交付;公式必须能重算,数字不能手算填入。 - 编辑现有文件时先找它的输入单元格约定(颜色/底纹标记),只写输入格,不动现有公式;
.xlsm需keep_vba=True保留宏。
xlsx 隶属于 Aiglade Skill 库。在 Aiglade 聊天框中用自然语言描述需求即可调用。