excel-sheet

Excel 电子表格工作流

技术栈目标 / 版本：Excel 桌面版，或基于 openpyxl 的电子表格自动化，采用当前兼容 OOXML 的工作流。

当交付内容为 .xlsx 工作簿，或电子表格结构很重要时，使用此技能。

• 在可用的情况下，利用原生并行子 Agent 调度功能和 200k+ 上下文窗口。

当前 MCP 实际情况

Excel MCP 工具取决于宿主环境。在 GitHub Copilot 中，Excel 操作可能会以分组的 Office 工具形式出现。在 Codex 或 Claude 中，这些工具可能完全不存在。请将附带的 Python 脚本视为可靠的备用方案。

激活条件

使用“症状 -> 操作”触发条件：符合其中一项时，应用此技能并按照下方协议进行验证。

• 创建或更新工作簿
• 将 CSV 数据转换为结构化的 Excel 输出
• 应用公式、格式、图表或数据透视表
• 在布局很重要时生成电子表格交付物

实用工作流

1. 确认客户端是否提供电子表格 MCP 工具。
2. 如果有，先检查实际工具名称，不要假定存在包装器。
3. 如果没有，使用本地转换器，或通过 openpyxl 创建工作簿。
4. 在声称工作簿已就绪之前，验证公式和图表范围。

MCP 备用方案 – 原生自动化

MCP 不可用时，请使用原生自动化：.xlsx 文件使用 openpyxl，扁平数据使用 CSV 导出，高风险计算则手动检查公式。保留公式、数字格式、工作表名称、隐藏工作表和工作簿元数据，然后重新打开或解析工作簿，再声称任务成功。

跨客户端可移植性

此技能旨在兼容 GitHub Copilot、Claude Code 和 Codex。

• GitHub Copilot：将文件夹放在 Copilot 可见的技能路径中；如果无法发现文件夹，则将工作流写入项目说明。
• Claude Code：将文件夹放在本地技能目录或兼容的插件源中。
• Codex：将文件夹安装或同步到 $CODEX_HOME/skills/excel-sheet，并在进行重大更改后重启 Codex。

MCP 可用性与备用方案

首选 MCP 服务：Excel MCP

• 备用提示词：“在不使用 MCP 的情况下应用 Excel Spreadsheet Workflows 技能。遵循文档所述的本地或手动备用方案，展示所选工具，并报告验证证据。”
• 当电子表格 MCP 工具不可用时，使用 scripts/csv-to-xlsx.py、openpyxl 或桌面版 Excel。
• 在本地重新打开生成的工作簿，以验证公式、范围和冻结窗格。
• 当前宿主环境未提供相应功能时，不要声称使用了 MCP 操作。

反模式

• 认为源内容已经干净：格式自动化会照样保留错误或不一致的输入。
• 跳过打开文件进行验证的步骤：文档和电子表格常常不是在脚本输出阶段，而是在目标应用中出错。
• 未设置检查点就自动执行不可逆的编辑：小小的映射错误就可能影响整个工作簿或文档。

验证协议

在声称“技能已成功应用”之前：

1. 通过/未通过：编辑前已说明 Excel Sheet 工件类型、目标格式和所需的输出保真度。
2. 通过/未通过：已检查 MCP 的可用性；如果 MCP 不可用，已说明原生自动化备用路径。
3. 通过/未通过：已在本地打开、解析、渲染或以其他方式验证生成的文件或公式。
4. 压力测试场景：将工作流应用于包含格式、元数据或转换边界情况的文件，并验证重要内容均未丢失。
5. 成功指标：零未经验证的文档声明；工件本身就是证据。

工作簿检查清单

• 工作表名称清晰
• 标题格式统一
• 使用公式而非硬编码的派生值
• 图表引用正确的范围
• 在适用的情况下设置冻结窗格或筛选器

参考与资源

文档

• Excel 公式参考 - 公式模式、查找指南和 Power Query 说明

脚本

• CSV 转 XLSX 转换器 - 从 CSV 输入生成格式化 Excel 工作簿的本地备用方案

示例

• Excel 工作簿示例 - 工作簿结构和自动化模式示例

相关技能

• 文档编写：当工作流还需要起草结构化的技术或产品文档时使用。
• notion-docs：当工作流还需要发布 Notion 页面和数据库时使用。
• pdf：当工作流还需要 PDF 提取、生成和布局审查时使用。
• word-document：当工作流还需要编写和格式化 Word 文档时使用。