Excel 电子表格技能（xlsx）
让智能体专业地创建、编辑和分析 Excel 文件，保证零公式错误并保留原有公式与格式。
recalc.py 会向用户的 LibreOffice 用户配置目录写入 Basic 宏（写入 ~/.config/libreoffice 或 ~/Library/...），并直接在原文件上调用 calculateAll+store 覆盖保存，属于修改用户环境的持久性副作用，无用户确认、无备份或回滚机制，文档也未披露这一数据流。未发现恶意行为、凭据窃取或隐蔽外传，但确认、隔离与恢复缺失，扣至中档。
SKILL.md 工作流自洽，recalc.py 返回结构化 JSON 错误定位（错误类型、位置、公式计数），失败反馈质量较好；但依赖 LibreOffice 已安装且 soffice 在 PATH（宏创建失败仅返回笼统 error），超时依赖 Linux timeout / macOS gtimeout（缺失时无超时保护），错误归因逻辑（对 stderr 的关键字判断）脆弱。静态评审上限 10，且关键路径无专属测试覆盖，故给 10 不再上浮。
适用场景清晰（创建/编辑/分析 xlsx、公式重算、金融建模规范），触发描述较精确；但未声明边界与非适用范围，假定环境（LibreOffice、openpyxl/pandas）仅有口头假定，无中文支持说明；好在 LibreOffice 与 Python 库在目标环境可达，无完全依赖不可达海外服务的问题。
文档分层清晰（输出规范→工作流→检查清单→最佳实践），含常见坑与失败解释；但 skill 自身标注 'Proprietary. LICENSE.txt has complete terms' 而仓库根为 MIT 且未见该 skill 的 LICENSE.txt，许可归属存在矛盾，无 skill 级版本号/变更记录/维护责任人说明。
工作流（pandas 分析、openpyxl 保公式编辑、公式优先于硬编码、强制重算校验）针对真实需求，若按指引执行可产出可用文件；但无任何已提交的代表性输出、示例文件或针对该 skill 的测试证据，直接可用性只能静态推断，超出 7 的锚点不可达。
主材料（SKILL.md 与 recalc.py 源码）可审计、声明与脚本行为基本可交叉印证；但无覆盖该 skill 关键路径的测试、无执行证据、无第三方佐证，静态评审上限 5，实际证据覆盖薄，给 4。
- recalc.py 会向用户 LibreOffice 配置目录写入宏并原地覆盖保存 Excel 文件，使用前请自行备份目标文件；如不接受该副作用，避免运行重算步骤。
- 该 skill 标注为 Proprietary 而仓库整体为 MIT，许可条款文件未随附，商用前请核实许可合规。
- 运行前提（LibreOffice 已安装、soffice 在 PATH、openpyxl/pandas 可用）未经执行验证；macOS 缺少 gtimeout 时脚本无超时保护。
- 本评审为静态源码评审，未执行任何脚本，有效性结论仅为推断。
这个 Skill 能做什么，适合哪些场景？
这是 Mini-Agent 仓库（MiniMax-AI/Mini-Agent，MIT 许可，共捆绑 15 个技能）中的一个技能，位于 mini_agent/skills/document-skills/xlsx/。它指导智能体使用 pandas 做数据分析、openpyxl 处理公式与格式，并通过 recalc.py 调用 LibreOffice 重算公式并检查 #REF!、#DIV/0! 等错误。技能内置财务建模规范：行业通用的颜色编码、数字格式和硬编码来源标注要求。适合需要可靠产出可审计电子表格的用户。
用 pandas 读取 .xlsx/.xlsm/.csv/.tsv 并做分析与可视化；用 openpyxl 新建或修改工作簿，写入 Excel 公式（而非硬编码计算值）并保留既有格式；用 recalc.py 通过 LibreOffice 重算全部公式，返回 JSON 格式的错误定位报告供修复；强制执行财务模型规范——蓝色输入/黑色公式/绿色跨表引用的颜色约定、$#,##0 与 0.0% 等数字格式、假设单元格分离，以及硬编码值的来源注释。
- 分析师需要从零生成带公式和格式的财务或业务模型，且要求交付时零公式错误
- 数据人员拿到陌生 Excel 文件，需要快速读取、统计汇总和探索多张工作表
- 用户要更新既有模板文件，同时必须原样保留原有的公式和排版约定
- 财务人员需要符合投行颜色编码与数字格式规范的估值或预测模型
- 开发者希望脚本化批量修改 Excel 并自动验证公式是否有 #REF!、#NAME? 等错误
这个 Skill 有哪些优点和局限？
- 工作流完整：读取、编辑、写入、公式重算、错误验证形成闭环
- 强制使用 Excel 公式而非硬编码值，产出文件保持动态可更新
- 内置行业级财务建模规范（颜色编码、数字格式、假设分离、来源标注）
- recalc.py 返回结构化 JSON 错误报告，便于自动定位和修复问题
- SKILL.md 标注为专有许可（见 LICENSE.txt），与仓库整体的 MIT 许可不同，商用前需核对条款
- 公式重算强依赖 LibreOffice，未安装则无法完成重算环节
- 源材料未提供该技能专属的测试覆盖证据；README 的测试套件针对 Mini-Agent 主体而非此技能
- 拆出 Mini-Agent 单独使用时的安装方式未在文档中说明
如何安装这个 Skill？
该技能随 Mini-Agent 集合安装：uv tool install git+https://github.com/MiniMax-AI/Mini-Agent.git，然后运行 setup-config.sh 或 setup-config.ps1 生成 ~/.mini-agent/config/config.yaml 并填入 MiniMax API Key。开发模式则 git clone 仓库后执行 uv sync 和 git submodule update --init --recursive 来初始化技能。技能文件位于 mini_agent/skills/document-skills/xlsx/。注意：将此单个 SKILL.md 手动放入其他 Agent Skills 客户端的具体步骤在源材料中未说明。
如何使用这个 Skill？
在 Mini-Agent CLI 中启动（mini-agent 或 mini-agent --workspace /path/to/project），用自然语言提出电子表格任务，例如"读取 sales.xlsx 并生成带 SUM 公式的汇总表"。若涉及公式，智能体需运行 python recalc.py output.xlsx 重算，并根据返回的 JSON（status 为 errors_found 时查看 error_summary）修复错误后重算。运行环境需已安装 LibreOffice。
这个 Skill 与同类方案有什么区别？
SKILL.md 引用 Claude Skills（https://github.com/anthropics/skills）作为上游来源，本技能即该体系下的 xlsx 技能，随 Mini-Agent 捆绑分发；源材料未提及其他可比竞品。