SuperAPI AI 工具集

xlsx

办公与效率

查看项目

更新于 10-16 08:54

技能介绍

用途

xlsx 是一个面向电子表格文件的高级操作、分析与创建技能,覆盖 XLSX、XLSM、CSV 等格式。其核心目标是最终交付一个或多个 Excel 文件,且交付物中必须包含 .xlsx 文件。

主要能力

  • Excel 文件创建:使用 Python 3 配合 openpyxl(负责创建、样式、公式)与 pandas(负责数据处理后经 openpyxl 导出)。
  • 校验与错误检查:通过 KimiXlsx 命令行工具执行 recheck(检测公式错误、零值单元格、隐式数组公式)、reference-check(检测越界引用、表头行引用、聚合范围过小、公式模式不一致)、validate(OpenXML 结构校验)等。
  • 结构分析:inspect 命令输出 JSON,描述所有工作表、表格、表头与数据范围。
  • 数据透视表:pivot 命令使用纯 OpenXML SDK 创建数据透视表,并可自动附带柱状图、折线图或饼图。使用前必须阅读 pivot-table.md。
  • 图表验证:chart-verify 命令确认所有图表包含实际数据。

使用方式

创建 Excel 时使用 ipython 工具运行 openpyxl/pandas 代码;校验与透视表命令通过 shell 工具调用,可执行路径为 /app/.kimi/skills/kimi-xlsx/scripts/KimiXlsx。

工作流要求逐表校验:对每个工作表依次执行 PLAN(设计结构、公式、引用)、CREATE(写入数据、公式、样式)、SAVE(保存工作簿)、CHECK(运行 recheck 与 reference-check 直至 0 错误),通过后再进入下一张表。全部工作表完成后运行 validate,退出码为 0 才可交付。

公式优先:任何分析任务默认且优先使用 Excel 公式,仅在数据来自外部来源、为常量或会产生循环引用时才使用静态值。

外部数据必须附来源引用:使用两列“Source Name | Source URL”,不使用 HYPERLINK 函数;若逐行引用不可行,则创建专门的 Sources 工作表。

适用场景

适用于需要生成或处理 Excel 电子表格的任务,包括数据汇总、分类聚合、交叉分析、数据透视表与图表创建,以及对外部抓取数据进行整理并附带来源引用的场景。

限制

  • 禁止使用与旧版 Excel 不兼容的函数,如 FILTER、UNIQUE、SORT、SORTBY、XLOOKUP、XMATCH、SEQUENCE、LET、LAMBDA、RANDARRAY、ARRAYFORMULA、QUERY、IMPORTRANGE 等,需改用传统替代方案。
  • 数据透视表必须使用 pivot 命令创建,禁止用 openpyxl 手动构建;且不得用 openpyxl 再次打开透视表输出文件,否则会破坏 pivotCache 路径。
  • 若需为含透视表的文件添加额外工作表,应先用 openpyxl 创建全部工作表,最后再运行 pivot 命令。
  • validate 失败时不得尝试“修复”文件,应从零重新生成。
  • recheck 报告的任何错误必须在交付前修复,零容忍。
  • 财务数值应以最小单位存储(如 15000000 而非 1.5M),显示格式使用 Excel 格式。

关于收费、价格、平台支持范围等具体信息,资料中暂未提供。