xlsx

xlsx 技能概览

xlsx 能做什么

xlsx 技能适用于以电子表格文件为主要输入或最终输出的任务。需要读取、创建、修复、更新或转换 .xlsx、.xlsm、.csv、.tsv 文件，而且最终交付物应是可直接使用的表格文件，而不只是解释说明或一段脚本时，就该用它。

什么场景最适合 xlsx 技能

如果你在 agent 工作流里需要稳定可靠地处理电子表格，xlsx 技能会很合适：比如财务模型、运营跟踪表、表格数据清洗、模板更新、批量填充公式、格式修复、生成适合做图表的工作簿，以及文件格式转换。尤其是当用户明确提到真实文件路径，并希望最终拿回一个修改后的工作簿时，这个技能的价值会更明显。

xlsx 真正解决的是什么问题

多数用户并不是想发一个泛泛的“分析这张表”请求。他们真正需要的是一个能正常打开、结构不乱、格式合理、公式不报错的工作簿。xlsx 技能围绕的就是这个实际结果：产出能在 Excel 类工作流中直接使用的电子表格文件，而不是只描述“理论上应该怎么做”。

xlsx 与普通表格提示词的区别

xlsx 最突出的差异在于它对输出结果的约束非常明确。这个技能强调专业级电子表格交付、公式零错误，以及在修改既有文件时尽量保留原始模板结构。仓库里还提供了用于解包/重打包 Office 文件，以及通过 LibreOffice 触发公式重算的辅助脚本；相比只靠提示词处理表格，这套做法更具体，也更接近真实交付场景。

采用前需要知道的关键限制

如果你的真实交付物其实是 Python ETL、数据库流水线、Google Sheets 集成、HTML 报表或 Word 文档，那它并不适合你。它也不是一本通用的电子表格理论指南。xlsx 技能的价值很聚焦：当你更看重文件保真度和工作簿输出，而不是抽象地讨论数据时，它才最有用。

许可与使用限制

仓库中的技能材料受 Anthropic 条款约束，另外还有 LICENSE.txt 里的额外限制。对目录用户来说，实际要点很简单：把它视为服务内使用的 skill 资源，而不是一个可以随意拆出来再分发的开源电子表格工具包。

如何使用 xlsx 技能

xlsx 的安装方式与使用语境

仓库并没有在 SKILL.md 里单独写明专用安装命令，但在 Anthropic 的 skills 工作流中，通常会这样添加：

npx skills add https://github.com/anthropics/skills --skill xlsx

安装后，只要任务核心是创建或修改电子表格文件，就应该调用这个 xlsx 技能。

xlsx 技能需要哪些输入

要给这个技能真实的文件上下文，而不是一个模糊目标。高质量输入通常包括：

• 文件路径或上传的工作簿
• sheet 名称
• 目标列或目标区域
• 需要使用的公式
• 格式要求
• 是否必须原样保留现有模板
• 目标输出格式：.xlsx、.xlsm、.csv 或 .tsv

如果工作簿本身比较混乱，还要说明哪一行算表头、哪些字段才是权威来源，以及格式异常的行该如何处理。

把模糊目标改写成可执行的 xlsx 提示

弱提示：

• “Fix this spreadsheet.”

更好的 xlsx 使用提示：

• “Update forecast.xlsx. In sheet Q3 Plan, add a new column Gross Margin % after column H, fill formulas for all populated rows, preserve all existing formatting and formulas elsewhere, and ensure the workbook opens with no formula errors.”

之所以要写到这个程度，是因为这个技能优化的是文件输出质量，而不是替你猜测需求。

能提升输出质量的提示模式

一个可靠的 xlsx for Spreadsheet Workflows 提示模板是：

1. 先明确文件
2. 指明具体涉及哪些 sheet
3. 说明结构性改动
4. 定义计算规则
5. 写清保留规则
6. 说明最终需要返回什么输出文件

示例：

• “Using sales_template.xlsm, update only the Monthly Summary and Raw Data sheets. Import the attached CSV into Raw Data, keep macros untouched, preserve all existing styles, refresh dependent formulas, and return a corrected .xlsm.”

实际工作中推荐的 xlsx 流程

一个实用的 xlsx 使用流程通常是：

1. 先检查工作簿结构和各个标签页
2. 判断这是全新构建、模板修改，还是修复任务
3. 按 sheet 进行有针对性的改动
4. 检查公式和引用关系
5. 必要时执行重算
6. 按要求格式返回工作簿

这套顺序能减少最常见的问题：表面上做出一个“看起来没问题”的 sheet，但实际上破坏了下游引用或模板约定。

建议优先阅读这些仓库文件

如果你想在信任这个技能之前先弄清它的工作方式，建议先看这里：

• skills/xlsx/SKILL.md
• skills/xlsx/scripts/recalc.py
• skills/xlsx/scripts/office/unpack.py
• skills/xlsx/scripts/office/pack.py
• skills/xlsx/scripts/office/soffice.py
• skills/xlsx/scripts/office/validate.py

从这些路径入手，通常是理解实际行为的最快方式，比只看高层说明更有效。

为什么这些辅助脚本很重要

这些内置脚本说明，xlsx 不只是“改改表格内容”这么简单。仓库支持 Office 文件的解包/打包流程，也支持借助 LibreOffice 做公式重算。当普通工作簿编辑导致缓存公式未刷新，或者你需要更可控地处理 OOXML 包内容时，这一点就非常关键。

关于重算与 LibreOffice 的预期

scripts/recalc.py 会借助 LibreOffice 强制执行公式重算并保存工作簿。如果你的文件在结构性修改后必须以最新计算值交付，这会特别有用。从采用角度看，这也意味着：如果你的环境能运行 soffice，xlsx 技能会更有说服力。

需要尽早知道的环境依赖

如果你打算围绕仓库自带脚本做更深入的 xlsx 自动化，通常要预期以下依赖：

• 运行辅助脚本所需的 Python 环境
• openpyxl
• LibreOffice / soffice
• 在某些环境中，还需要像 gcc 这样的编译器，以支持 scripts/office/soffice.py 使用的 soffice shim 路径

这些依赖不会妨碍普通 skill 使用，但会直接影响你是否能在本地复现仓库里的校验与重算流程。

保留模板不变的编辑必须明确说明

这个技能给出的 xlsx 实操要点之一，就是更新现有模板时要尽可能原样保留。如果你修改的是财务模型、董事会汇报工作簿，或受监管约束的模板，最好明确写出：

• 不要重做工作簿样式
• 保留字体、列宽、数字格式和 sheet 顺序
• 只修改指定单元格、列或标签页

如果不加这些约束，一个通用表格编辑即使在数据层面“做对了”，也可能在业务层面依然算失败。

xlsx 最擅长的任务类型

xlsx 技能最强的场景，是那些明确、边界清晰的工作：

• 添加公式
• 清洗导入后的数据行
• 把 CSV/TSV 转成可用工作簿
• 更新现有 sheet 且不破坏版式
• 产出对公式错误容忍度很低的高完成度电子表格文件

但如果你真正要做的是探索式数据分析，最终落点是 notebook、SQL 工作流或 BI 工具，那它的吸引力就没那么强。

xlsx 技能常见问题

xlsx 比普通的表格提示词更好吗？

通常是的，前提是你要的输出必须是真实可用的工作簿。普通提示词往往更偏向解释说明，而 xlsx 技能从一开始就是围绕电子表格交付、工作簿结构保留和实际文件编辑约束来设计的。

xlsx 技能对新手友好吗？

友好，前提是你的任务足够具体。只要能提供文件、说明想改什么，并避免“让它看起来更专业一点”这种定义不清的请求，新手也能较顺利地用好 xlsx。这个技能最适合那种工作簿任务边界非常明确的场景。

什么情况下不该用 xlsx？

如果你的最终交付物主要是以下内容，就不建议使用 xlsx：

• 脚本
• 数据库工作流
• Web 报表
• Google Sheets API 集成
• 不需要电子表格文件的叙述型分析

在这些情况下，xlsx 技能带来的价值通常不如面向代码、分析或报表的技能。

xlsx 能处理公式报错和工作簿修复吗？

这是选择它的核心原因之一。这个技能明确把“公式零错误”作为优先目标，仓库里也提供了重算支持。不过，修复质量仍然取决于你是否把目标工作簿的逻辑说清楚。

xlsx 也支持 CSV 和 TSV 吗？

支持。xlsx 技能覆盖 .csv 和 .tsv 场景，尤其适合目标是清洗、重组，或把表格型数据转换成规范电子表格输出的时候。

xlsx 适合处理启用宏的文件吗？

有可能适合，尤其是对 .xlsm 文件做范围有限的更新时。但带宏工作簿的风险更高。你需要明确要求保留宏、避免无关改动，因为最安全的使用方式仍然是定点修改，而不是深入做 VBA 重构。

如何提升 xlsx 技能的使用效果

不只说怎么改，还要给出业务规则

想提升 xlsx 的结果质量，最快的方法就是解释清楚工作簿背后的业务逻辑。与其只说“把公式向下填充”，不如写成“在 Transactions 中，对每一行非空记录计算 Net Revenue = Gross Revenue - Discounts - Refunds。” 这样更有助于技能识别结构不一致和公式边界情况。

一开始就说清楚哪些不能动

想把 xlsx 用好，最好提前明确哪些内容绝不能改：

• sheet 名称
• 目标区域之外的公式
• 宏
• 格式
• 隐藏标签页
• 命名区域
• 列顺序

这些约束往往比宽泛的样式要求更重要，因为电子表格任务很容易败在“顺手改坏了别的地方”。

对脏数据的处理规则要尽量减少歧义

如果源数据不一致，就直接告诉 xlsx 该如何归一化：

• 哪一行才是真正的表头
• 是否要删除空白行
• 如何处理重复 ID
• 日期格式是 MM/DD/YYYY 还是 DD/MM/YYYY
• 哪些值应视为 null

这往往就是“工作簿能不能真正用起来”和“只是表面上清理过了”之间的区别。

不只要输出，也要要求校验

更好的 xlsx 使用提示，不只是让它返回文件，还会要求做检查，例如：

• 确认不再存在公式错误
• 在插入列后验证 sheet 引用是否正确
• 保留未修改区域的既有样式
• 确保汇总值仍然能对得上

这些检查项正好对应这个技能最有价值的地方：可信的电子表格输出。

第一版工作簿出来后，用迭代方式继续优化

拿到第一版结果后，重点复查：

• 几行有代表性的公式
• 边界位置的格式
• 汇总和 rollup
• 看起来像外部引用的链接
• 清洗数据时可能隐含的假设

然后再发一个范围更窄的第二轮提示。xlsx 任务通常通过迭代提升得更快：一次只纠正一种工作簿行为，比把整个任务从头重说一遍更有效。

留意常见失败模式

xlsx 最常见的问题包括：

• 插入列后引用关系断裂
• 公式复制到了错误的行范围
• 无意中重做了现有模板样式
• 文本数字或日期解析错误
• 跳过重算后留下过期的计算值

如果工作簿是业务关键文件，这些点正是你应该在提示里明确提出来的内容。

用示例行和目标样例提升结果

如果可以，尽量提供：

• 3 到 10 行有代表性的数据
• 一个正确最终公式的示例
• 一个期望格式的示例
• 一个错误行的示例，以及它应该如何被修正

对于 xlsx for Spreadsheet Workflows 来说，示例往往比抽象说明更有效，因为它同时锚定了结构和预期输出。

当保真度要求最高时，直接用仓库脚本

如果你是在认真评估 xlsx 技能，不要只快速浏览 SKILL.md，最好把辅助脚本也一起看并用起来。unpack.py、pack.py 和 recalc.py 更能体现这个仓库在 OOXML 处理、校验和重算上的实际做法。相比一段泛泛的功能总结，这能帮助你做出更准确的安装判断。

了解 xlsx 技能的能力上限

xlsx 技能能提升电子表格输出的可靠性，但它并不能替代复杂财务、审计或监管模型中的领域复核。如果一条错误公式就可能带来实质性风险，那么更合理的做法是：把 xlsx 当成加速器，同时依然认真复查工作簿逻辑。