1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 正式名称 | minimax-xlsx-minimax-ai-skills(自述名称:MiniMax XLSX Skill) | 合集仓库子目录名 + GitHub API |
| 所属合集仓库 | MiniMax-AI/skills(MiniMax AI 官方开源技能仓库) | GitHub |
| 作者/维护者 | MiniMax-AI | GitHub 组织账号 |
| 来源链接 | https://github.com/MiniMax-AI/skills/tree/main/skills/minimax-xlsx | — |
| 许可证 | MIT | 仓库根目录 LICENSE + SKILL.md front matter |
| 所属仓库整体 Stars/Forks | 13,197 / 1,131(该数字属整个合集,不代表本技能自身热度,仅供了解仓库规模) | GitHub API |
| 该技能自身活跃度 | 自身专属提交 2 次(均在 2026-03-22,此后无更新);仓库 Issue 中有 3 条专门讨论该技能(依赖声明缺失、第三方评测收录、跨 Agent 适配诉求) | GitHub API / Issue 搜索 |
| 最新版本 | 1.0(SKILL.md metadata) | SKILL.md |
| 安装方式 | Claude Code 插件市场一条命令安装;也可手动复制 skills/minimax-xlsx 目录到本地 skills 路径 |
官方仓库 README |
2. 功能介绍与亮点
minimax-xlsx 是面向 Excel/表格文件(.xlsx/.xlsm/.csv/.tsv)的创建、读取、编辑、修复与校验技能,核心设计围绕“零格式丢失”:
- XML 直接操作而非 openpyxl 往返:编辑已有文件时走“解包→改 XML→打包”流程,SKILL.md 明确写明“绝不对已有文件做 openpyxl round-trip”,理由是这类往返操作会破坏 VBA 宏、数据透视表、迷你图等复杂结构。
- 公式优先原则:任何计算结果必须写成 Excel 公式(如
<f>SUM(B2:B9)</f>),不得用 Python 算出数值后硬编码,确保交付的表格是“活”的。 - 金融建模配色规范:输入值用蓝色字体、公式用黑色、跨表引用用绿色,对齐华尔街财务模型的通用惯例。
- 任务路由表 + 分层参考文档:READ/CREATE/EDIT/FIX/VALIDATE 五类任务各自对应专门的参考文档(
references/下 5 份)与工具脚本(xlsx_reader.py、xlsx_pack.py/xlsx_unpack.py、xlsx_add_column.py、xlsx_insert_row.py、formula_check.py),并提供可选的libreoffice_recalc.py做动态公式重算校验。 - 行/列插入的细节纠错:文档专门提醒“插入行时按文本标签定位真实行号,而非直接信任任务描述里的行号”,以及“整行加边框需覆盖所有已有单元格,而非只覆盖新增部分”,体现出对真实使用中常见踩坑点的针对性设计。
亮点:① MiniMax 为公开的 AI 大模型厂商官方账号出品;② 全程本地文件读写,不依赖 pip/npm 安装第三方库即可完成核心的读取与结构发现;③ 至少 6 个独立第三方技能目录站(mcpmarket.com、aiskill.market、skills.rest、powerpoint.md、claudemarketplaces.com、claudeskills.info 等)已收录该技能。
3. 适用场景
固定分类:文档与办公自动化
适用于:编辑他人制作的、含复杂格式(条件格式、透视表、图表)的既有 Excel 文件且不希望破坏原有结构;从零生成带公式而非静态数字的财务模型或预算表;批量给现有表格插入行列并自动延续相邻单元格的样式与公式;对已有表格做公式正确性校验与修复。受益人群:需要频繁处理他人 Excel 文件的数据分析师、财务与运营人员、需要将分析结果交付为“可复核活表格”而非截图或静态数字的报告制作者。
4. 跨 Agent 兼容性
- Claude Code:原生支持——官方提供插件市场一条命令安装路径(
claude plugin marketplace add+claude plugin install),并附带.claude-plugin/配置 - Codex:官方文档提供专门的安装步骤(git clone + symlink 配置),判定为原生支持
- OpenClaw:不支持——曾有独立用户在仓库 Issue #20 中请求官方适配,维护者未提供正式方案,仅有其他用户回复“手动让 OpenClaw 读取该仓库”的变通说法,未见后续代码改动
- Hermes Agent:未验证——官方文档与仓库配置文件均未提及
5. 推荐理由
在“编辑已有 Excel 文件不破坏原格式”这个具体而高频的真实痛点上给出了针对性方案:绕开 openpyxl 往返编辑的已知缺陷,用 XML 直接操作保留 VBA/透视表/迷你图等复杂结构,同时坚持公式优先,避免生成“看起来对但其实是死数字”的报表。核心读取与结构发现流程不依赖第三方库安装,安全边界清晰(全程本地文件操作,无网络外发)。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 7 | 所属合集仓库 13,197 stars 不可直接记给单个子技能;但该技能被 mcpmarket.com、aiskill.market、skills.rest、powerpoint.md、claudemarketplaces.com、claudeskills.info 等至少 6 个独立第三方目录站收录,且仓库 Issue 区有真实用户就该技能的依赖问题与跨 Agent 适配单独提出过诉求(非泛泛提及整个仓库) |
| 可用性 | 7 | 插件市场一条命令安装;5 份分层参考文档 + 完整工具脚本覆盖 READ/CREATE/EDIT/FIX/VALIDATE 全流程;但仓库 Issue #30 记录了真实用户在全新环境运行时遇到 ModuleNotFoundError(依赖未在技能目录内声明、SKILL.md 未给出环境准备说明),且该技能自身自 2026-03-22 加入后无后续专属提交 |
| 安全性 | 9 | 见下方检查清单 |
安全检查清单: ① shell 命令执行——脚本均为本地文件读写与可选的本地 LibreOffice 调用(用于公式重算校验),无任意代码执行迹象 ② 联网外发——通读全部脚本与文档,未见任何网络请求,全程本地文件操作 ③ 凭据存储——不涉及,无需任何 API Key 或账号凭据 ④ 可疑指令——通读 SKILL.md 及全部参考文档,指令均为表格读写与校验逻辑,未见诱导性或隐蔽外发代码 ⑤ 作者信誉——MiniMax 为公开的 AI 大模型厂商官方账号,无刷星或虚假宣传迹象 ⑥ License——MIT,仓库根目录与 SKILL.md 均明确声明 ⑦ 最近维护——仓库整体 3 个多月前有过更新,该技能自身自 2026-03-22 加入后未见后续专属提交,但已有的依赖声明问题(Issue #30)已被维护者标记为已处理
7. 跟同类 Skills 相比的优势
| 技能 | 核心定位 | 与 minimax-xlsx 的差异 |
|---|---|---|
| xlsx(anthropics/skills 官方技能) | Excel 处理,同样坚持公式优先与金融建模配色规范,强制走 LibreOffice 重算校验闭环 | 许可证为源码可见但非开源的 Proprietary 条款(仅限 Anthropic 服务范围内使用),而 minimax-xlsx 为 MIT 更宽松;两者理念相近(公式优先、颜色编码),但 minimax-xlsx 更强调“绝不对既有文件做 openpyxl 往返”这一具体编辑机制 |
| sn-da-excel-workflow(商汤 SenseNova) | 端到端数据分析编排器:清洗→筛选→跨表聚合→可视化→导出的完整数据分析链路,10 个模块化子能力 | 定位是“数据分析工作流”,覆盖面更广但偏向从数据到报告的分析场景;minimax-xlsx 更聚焦“保真编辑已有表格文件”这一具体动作,两者可视为分析与格式保真两种不同切入点 |
| xlsx-win(dachent/skills,Windows 专属) | 基于 Windows Excel COM 自动化的原生刷新/重算/校验方案,含 C# 监督程序 | 需要 Windows + Microsoft 365 桌面版 Excel 才能运行,覆盖面明显更窄;minimax-xlsx 跨平台运行、无需安装 Office 桌面程序 |
8. 用户评价
第三方技能评测站 powerpoint.md(独立目录,无付费列表与联盟链接,最后审核于 2026-04-28)对该技能给出量化评分:XML 格式保留 4.9/5、功能完整性 4.6/5、公式支持 4.5/5、易用性 4.0/5,总体定位为“最适合在保持格式完整的前提下编辑既有 Excel 文件”的选择;同时指出其编辑机制要求用户理解 OOXML 结构,对新手有一定学习曲线,不适合“只想简单 pip 安装”的用户。仓库 Issue #30 中,用户 hushicai 具名报告了该技能在全新环境下因缺少依赖声明而运行失败的问题。
9. 其他补充
同一仓库内还包含面向 PDF 生成的 minimax-pdf、面向 PPT 生成的 pptx-generator、面向 Word 文档的 minimax-docx,四者共享相似的设计语言(本地文件操作优先、强调保留原始格式与结构),可视为 MiniMax 官方的文档办公技能族。
10. 安装使用方式
Claude Code(推荐):
claude plugin marketplace add https://github.com/MiniMax-AI/skills
claude plugin install minimax-skills
Codex / OpenCode(手动):
git clone https://github.com/MiniMax-AI/skills.git
# 按官方 README 中的 Codex/OpenCode 章节建立 symlink 或复制 skills/minimax-xlsx 到对应技能目录
安装后无需重启,触发关键词(“spreadsheet”、“Excel”、“.xlsx”、“pivot table”、“financial model”、“formula”等)出现在对话中即会自动加载该技能;使用可选的公式重算校验功能(libreoffice_recalc.py)时,需本机已安装 LibreOffice。
11. 注意事项
- 全新环境首次使用时可能因缺少
pandas/openpyxl等常见库而报ModuleNotFoundError,SKILL.md 本身未给出显式的环境准备步骤,建议使用前确认本地 Python 环境已具备常用数据处理库 - 编辑既有文件走的是 XML 直接操作路径,理解成本高于“调库一把梭”的方案,初次接触需要一定学习曲线
- 官方文档未提及 Hermes Agent 支持,OpenClaw 官方适配请求(Issue #20)截至目前未见正式落地
- 该子技能自身自 2026-03-22 加入仓库后暂无后续专属更新,长期维护活跃度有待观察