前言¶
在 Cursor、Claude Code 等环境里让模型改 Excel，常见问题是格式被抹平、透视表或宏丢失，CSV 还会出现 GBK 与 UTF-8 混用导致的乱码。手写 openpyxl 或 pandas 脚本能跑通，但要自己处理编码、公式重算和版式，成本不低。
下面介绍 SkillHub 社区 Skill「xlsx优化版」（坐标 @user_c66b8218/xlsx007-skill，版本 1.0.0）。它用通用 SKILL.md 约束 Agent 的工作方式，面向 .xlsx、.xlsm、.csv 等表格文件的打开、创建、分析与编辑，并强调中文与 CJK 场景下的编码与版式处理。
这是什么¶
xlsx优化版是 SkillHub 分类 office-efficiency 下的社区 Skill，发布者为 user_c66b8218，标签 requires_api_key=false（按页面说明无需 API Key）。官方简介将其定位为：在尽量零格式损失的前提下，完成电子表格的创建、读取、分析、编辑、修复与校验，并对中文内容提供一等支持。
与「只把表读成 DataFrame 再导出」的做法相比，它明确要求在编辑现有工作簿时保留透视表、VBA 宏、图表、迷你图、条件格式、命名区域等结构，并覆盖公式重算与校验、结果检视和专业排版等步骤。
核心功能¶
以下能力均来自 SkillHub 页面与 API 元数据中的官方简介，未单独核实的实现细节不展开。
支持的文件与场景¶
- 文件类型：
.xlsx、.xlsm、.xltx、.csv、.tsv。 - 任务类型：新建工作簿、读取与分析现有文件、填充与修改、修复与校验、报表/仪表盘/预算/财务模型、透视表、任意表格形数据输出。
中文与 CJK¶
- 文本与编码：中文文本；UTF-8、GB18030、GBK。
- 显示与惯例：全角字符、渲染中的 CJK 字体；中文数字与日期惯例（如 ¥、万/亿、年/月/日）。
编辑时尽量保留的结构¶
在修改已有工作簿时，简介中列出的保留项包括：透视表、VBA 宏、图表、sparklines、条件格式、命名区域；并包含公式重算与校验、可视化检视结果、应用专业格式。
触发方式¶
当用户提到 spreadsheet、Excel、workbook、表格、工作簿、.xlsx、.xlsm、.csv、pivot table、透视表、macro、宏、chart、图表、financial model、财务模型、formula、公式，或任何需要产出表格数据的请求时，Agent 应按该 Skill 的指引处理。
安装与启用¶
SkillHub 页面给出的安装方式是：让 AI 按 SkillHub 安装与优先源配置 安装坐标 @user_c66b8218/xlsx007-skill。下面是与该文档一致的 CLI 流程摘要。
1、检查或安装 skillhub CLI¶
先确认本机是否已有 CLI：
command -v skillhub && skillhub --version
若未安装，可使用官方安装脚本（完整安装含 CLI 与默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装到当前 Agent 的 skills 目录¶
安装技能时必须用 --dir 指向当前 Agent 识别的 skills 目录；默认装到 ./skills/ 可能不会被加载。常用路径（摘自官方安装文档）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令示例（将 <skills 目录> 换成上面对应路径）：
skillhub install @user_c66b8218/xlsx007-skill --dir <skills 目录>
也可在对话中直接发送页面提示词：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_c66b8218/xlsx007-skill`。
经过上面的步骤，重启或刷新 Agent 后，Skill 会随 SKILL.md 被加载；具体是否需重启以你所用客户端为准，安装文档提示安装目录错误时往往需要重启才能识别。
典型用法¶
公开页面未附带逐步代码示例，用法以自然语言任务 + Skill 内工作流为主。下列表述与官方触发词一致，便于在已启用 Skill 的会话中复现意图（Agent 会按 Skill 选择读写与校验方式，而非固定单行命令）。
- 新建：「用 Excel 做一份月度预算表，含科目、金额、备注，金额用人民币格式。」
- 读取分析：「读取
report.xlsx第二个 sheet，汇总各区域销售额并标出同比为负的行。」 - 在保留结构上修改：「在现有
model.xlsm里增加一列公式，不要破坏透视表和已有图表。」 - 编码与 CSV：「这份 GBK 的
.csv转成 UTF-8 的.xlsx，表头中文不要乱码。」 - 校验与修复：「检查工作簿里的公式引用是否断裂，并尽量保持条件格式不变。」
若需搜索同名或相关 Skill，可先执行：
skillhub search xlsx
再在结果中确认坐标为 @user_c66b8218/xlsx007-skill 后安装。
适用场景与注意¶
适合谁：经常让 Agent 处理 Excel/CSV、又在意版式与中文编码的开发者或分析岗位；需要改财务模型、透视表报表、带宏的 .xlsm 时，比纯脚本导出更贴近官方 Skill 的设计目标。
社区与版本：来源为 community，当前公开版本 1.0.0。SkillHub 元数据显示评分 100000、下载 2230（统计以 SkillHub 页面为准，会随时间变化）。
注意：
- 「零格式损失」是 Skill 的设计目标，复杂宏或极老格式仍建议在关键文件上保留备份，并在对话中说明可否接受另存为新文件。
- 无需 API Key 仅表示 Skill 元数据中的标签；你本地处理表格仍依赖 Agent 环境与可能安装的 Python/Office 相关工具，以 Skill 正文与实际执行为准。
- 安装目录必须对准当前客户端的 skills 路径，否则会出现「已 install 但 Agent 不生效」的情况。
结尾¶
xlsx优化版把表格类任务收敛到一套可重复的 Agent 指引：覆盖多格式文件、中文编码与惯例，并在编辑时强调保留透视表、宏、图表等结构。若你主要在 Cursor 或 Claude Code 里处理 Excel，可按上文安装到对应 skills 目录后，用表格相关自然语言直接驱动。
- SkillHub 页面：https://www.skillhub.cn/skills/user_c66b8218/xlsx007-skill
- API 元数据：https://api.skillhub.cn/user_c66b8218/xlsx007-skill
- 安装说明：https://skillhub.cn/install/skillhub.md
