Skill 多语言阅读指南
xlsx用途、用法与原始来源
当电子表格文件是主要输入或输出时,都可以使用此技能。这意味着用户需要执行以下任何操作:打开、读取、编辑或修复现有的 .xlsx、.xlsm、.xltx、.csv 或 .tsv 文件(例如,添加列、计算公式、格式化、绘制图表、清理混乱数据);从头开始或从其他数据源创建新的电子表格;或在表格文件格式之间进行转换。尤其当用户通过名称或路径引用电子表格文件时(即使是随意提及,例如“我下载的 xlsx 文件”),并希望对其进行操作或生成结果,则应触发此技能。此外,当需要清理或重构混乱的表格数据文件(格式错误的行、错位的标题、垃圾数据)并将其转换为正确的电子表格时,也应触发此技能。最终交付物必须是电子表格文件。如果主要交付物是 Word 文档、HTML 报告、独立的 Python 脚本、数据库管道或 Google Sheets API 集成,即使涉及表格数据,也不要触发此技能。
原文采集时间:
- SKILL.md
skills/xlsx/SKILL.md- 仓库 Star
- 185,373
- 仓库最近更新
- 2026/10/29
- 能力分类
- 数据
- 最近采集时间
许可:许可文件待核验
流程片段用于帮助阅读上游说明。本页没有执行第三方 Skill,不属于实测评测。
下面的用途和操作片段来自上游文档,由本站整理并翻译,和另行标注的 Codez 编辑分析分开展示。
这个 Skill 能做什么
当电子表格文件是主要输入或输出时,都可以使用此技能。这意味着用户需要执行以下任何操作:打开、读取、编辑或修复现有的 .xlsx、.xlsm、.xltx、.csv 或 .tsv 文件(例如,添加列、计算公式、格式化、绘制图表、清理混乱数据);从头开始或从其他数据源创建新的电子表格;或在表格文件格式之间进行转换。尤其当用户通过名称或路径引用电子表格文件时(即使是随意提及,例如“我下载的 xlsx 文件”),并希望对其进行操作或生成结果,则应触发此技能。此外,当需要清理或重构混乱的表格数据文件(格式错误的行、错位的标题、垃圾数据)并将其转换为正确的电子表格时,也应触发此技能。最终交付物必须是电子表格文件。如果主要交付物是 Word 文档、HTML 报告、独立的 Python 脚本、数据库管道或 Google Sheets API 集成,即使涉及表格数据,也不要触发此技能。
如何使用:上游操作流程
XLSX 文件的创建、编辑和分析
>openpyxl,pandas, 和markitdown已预装——无需运行pip install首先,编写脚本并直接导入。只有当导入失败时(或markitdown命令缺失):pip install缺少软件包。> 以下脚本路径相对于此技能的目录。
选择能够经受验证的公式
LibreOffice 实现的函数比 Excel 少,而且它无法计算的函数会变成字面值。#NAME?已写入您提供的文件中。首选 Excel 表格。2007-时代功能 —SUMIFS,INDEX,MATCH,IFERROR,SUMPRODUCT— 不需要前缀。
openpyxl 的陷阱
读取模型需要两次加载。data_only=True默认情况下,返回的是不包含公式的缓存值;而默认行为返回的是不包含值的公式字符串。一次操作无法同时满足这两个条件。data_only=True保存会破坏文件。该工作簿中已没有任何公式,因此保存会将所有公式永久性地替换为实际值。
python scripts/recalc.py output.xlsx [timeout_seconds] # default 30环境与依赖
每项输出的要求
除非用户另有说明,否则全文使用专业字体(Arial、Times New Roman)。公式零错误。绝不发货。recalc.py报告errors_found如果你认为某个错误发生在你之前,那就证明这一点:加载*原始*文件。data_only=True看看那个单元格。你引入的错误和你继承的错误看起来一模一样。
依赖关系
openpyxl,pandas,markitdown(pip,预安装——仅当导入失败或命令缺失时才安装)· LibreOffice(soffice通过自动配置为沙盒环境scripts/office/soffice.py)
限制与结果检查
重新计算(当文件包含公式时必须执行此操作)
openpyxl 将公式写入字符串,不缓存任何值。因此,在重新计算之前,每个公式单元格都会显示为字符串。None读取缓存值 —pandas,load_workbook(data_only=True)以及大多数预览程序。LibreOffice 会计算每个公式,文件会被直接重写,然后生成 JSON 格式的文本:status(success|errors_found),total_formulas,total_errors,以及一个error_summary命名至100每种错误类型的单元格(locations_truncated它说它扣留了多少——信任total_errors(不是列表的长度)。修复它命名的内容并再次运行。带有 JSON 的error钥匙而不是status这意味着没有重新计算任何内容,并且只有这种情况的非零值存在——errors_found出口0所以,千万不要把干净的退出当作干净的工作簿。
开始使用前
- 先核对支持的 Agent 宿主和仓库安装说明。保留完整 Skill 目录及其引用的脚本、资源和文档,只复制 SKILL.md 可能漏掉依赖。
- 向 Agent 提供实际输入、期望输出和验收标准。调用方式与可用工具取决于宿主环境,本站不假定存在通用的安装命令。
- 先在临时项目或输入副本上试用。涉及修改文件、远程服务或计费资源的操作,应逐项核对后再授权。
- 按照原文检查项和自己的需求验证输出。成功触发或仓库 Star 较高,都不能证明结果正确。
继续阅读原始文档
相关 Skill
翻译与介绍范围
本页从固定版本的上游 SKILL.md 整理用途与操作片段,译文使用辅助翻译。它不是完整手册,也不代表经过兼容性实测;使用前请核对原文及其引用文件。
介绍依据下方列出的固定版本;当前仓库动态和目录采集时间单独展示。
- 固定版本来源
- 阅读原文 ↗
- 原文采集时间
- 来源提交版本
ca45fc496a3436251f191354091d557da31c15b5- 原文 SHA-256
6712b39718fe815054abca9c3ee72f989613e6f771c8a5c58f30a65a6c905622