Excel 表格处理v1.0.0

免责声明：本站部分 Skill 来源于公开渠道，使用前请注意识别相关风险，内容版权归原作者所有，如 Skill 涉及版权问题，请在线反馈，核实后予以下架处理。

概述

本 Skill 面向需要程序化操作 Excel 工作簿的场景，覆盖从零创建到深度编辑的完整链路。核心交付物为符合专业排版规范的 .xlsx 文件，支持公式驱动计算（SUMIFS、INDEX/MATCH 等）、财务模型专用配色（蓝字输入/黑字公式/绿字跨表引用）、以及批量数据吞吐。内置强制重算验证机制：通过 LibreOffice 后端执行 scripts/recalc.py，在交付前检测并定位 #NAME?、#VALUE! 等公式错误，避免 openpyxl 写入后公式无缓存值导致的静默失效。同时提供跨平台 LibreOffice 自动配置，适配沙箱化运行环境。

技能包含

• SKILL.md（本文件）：技能主说明，含 openpyxl 与 pandas 选型策略、公式兼容性白名单、财务模型格式规范及重算验证流程
• README.md：安装与基础使用指引
• references/zh-CN.md：中文输入输出专用参考
• scripts/：10 个辅助脚本
  • recalc.py：LibreOffice 强制重算与错误检测（核心验证工具）
  • helpers.py、validators.py、validators_base.py：通用校验与辅助函数
  • validators_docx.py、validators_pptx.py、validators_redlining.py：跨格式校验扩展
  • pptx_chart.py、pptx_slide.py、pptx_theme.py：PPTX 关联图表与主题处理
  • soffice.py：沙箱环境 LibreOffice 自动配置
• schemas/：OOXML 标准 XSD 模式定义集（sml.xsd、dml-.xsd、wml-.xsd 等 40 余个），用于底层格式校验

核心能力

• 公式安全写入：优先使用 Excel 2007 原生函数，支持 _xlfn. 前缀的 6 个兼容函数，主动拦截 XLOOKUP/XMATCH 等不可计算函数
• 强制重算验证：交付前自动调用 LibreOffice 重算全表，输出 JSON 错误报告（含错误类型、单元格位置、截断提示）
• 财务模型规范：内置蓝/黑/绿/红四色语义配色、货币与百分比格式、零值渲染为 -、负数括号表示、假设单元格独立标注
• 双模式读写：openpyxl 精细控制公式与格式，pandas 高效批量数据吞吐，markitdown 快速预览多 sheet 结构
• 跨文件链接保护：检测并阻止对外部工作簿链接的破坏性保存，提供 --force 显式覆盖选项

应用场景