Excel 工艺（免费版）

本 Skill 把 Excel 生成任务脚本化——通过 Python 与 openpyxl 生成结构化、可复用、可版本控制的 .xlsx 文件。免费版覆盖日常报表生成场景。

概述

手工制表痛点明显：每月重复同样操作、修改一处要手工同步到多处、版本难以管理。本 Skill 把制表过程转化为可执行脚本，支持参数化模板、批量生成、版本控制。所有输出兼容 Excel / WPS / LibreOffice，跨平台无障碍。

核心能力

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输入: 用户提供结果处理与输出所需的指令和必要参数。 处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志。

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：Excel、文件生成器、支持多、图表与基础格式、适合日常表格生成、工艺免费版面向需、要程序化生成、文件的开发者与运、营人员、提供多、图表与基础格式化、openpyxl、Python、输出兼容、WPS、LibreOffice、Use、when、需要文件处理、文档转换、格式互转、内容提取时使用、不适用于加密文件等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景一：季度销售报告（运营角色）

按月份 × 产品生成销售表，自动计算总计与增长率，配套柱状图展示趋势。Agent 输出完整 Python 脚本，一键运行生成 .xlsx。

场景二：库存管理表（仓储角色）

多 Sheet 工作簿——按品类分 Sheet，每 Sheet 含入库、出库、库存三栏，公式自动算库存。

场景三：项目跟踪表（PM 角色）

任务列表 + 负责人 + 状态 + 完成度，条件格式高亮延期项。

场景四：个人记账本（个人角色）

按月分 Sheet，按日记录收支，自动汇总月度合计与饼图展示支出占比。

快速开始

1. 阅读## 核心能力章节了解skill功能
2. 按## 依赖说明配置环境
3. 执行所需能力对应的命令
4. 参考## 错误处理章节处理异常
5. 查看## FAQ解答常见疑问

# 依赖说明
pip install openpyxl
# ...
# 示例
python3 sales_report.py

最小化示例：

from openpyxl import Workbook
from openpyxl.styles import Font, PatternFill, Alignment
# ...
wb = Workbook()
ws = wb.active
ws.title = "销售数据"
# ...
# 标题
ws['A1'] = "2026 年第一季度销售报告"
ws['A1'].font = Font(bold=True, size=16)
# ...
# 表头
headers = ['月份', '产品A', '产品B', '产品C', '总计']
for col, h in enumerate(headers, 1):
    cell = ws.cell(row=3, column=col, value=h)
    cell.font = Font(bold=True, color='FFFFFF')
    cell.fill = PatternFill(start_color='3182CE', end_color='3182CE', fill_type='solid')
# ...
# 数据
data = [
    ['1月', 150000, 230000, 180000],
    ['2月', 180000, 250000, 200000],
    ['3月', 220000, 280000, 230000],
]
for r, row in enumerate(data, 4):
    for c, v in enumerate(row, 1):
        ws.cell(row=r, column=c, value=v)
    # 总计公式
    ws.cell(row=r, column=5, value=f'=SUM(B{r}:D{r})')
# ...
wb.save('sales_report.xlsx')
print("已生成 sales_report.xlsx")

配置示例

格式化类型对照表

图表类型选择

多 Sheet 跨引用

# Sheet1 引用 Sheet2 的 A1
ws1['A1'] = '=Sheet2!A1'
# ...
# 跨 Sheet 求和
ws1['A2'] = '=SUM(Sheet1:Sheet3!A1)
# ...
# 跨 Sheet 条件求和
ws1['A3'] = '=SUMIF(Sheet1!A:A, "条件", Sheet1!B:B)'

最佳实践

1. 先规划再写码：确定 Sheet 数量、字段、公式、图表位置后再开始，避免返工。
2. 格式集中管理：把格式对象定义为字典或常量，便于统一修改。
3. 公式优先于计算值：能写公式就别在 Python 里算死值，保留可编辑性。
4. 自动列宽收尾：所有数据写完后再调 auto_column_width，避免重复调整。
5. 中文注意编码：文件保存使用 UTF-8，openpyxl 默认支持中文。
6. 大文件分批写：超过 5 万行的表格用 write_only=True 模式，避免内存爆炸。

常见问题

Q1：生成的文件在 WPS 中格式错乱？

A：WPS 对部分高级格式（如条件格式、自定义数字格式）支持不全。建议测试时同时在 Excel 与 WPS 中打开验证。

Q2：图表数据范围设置错误？

A：检查 Reference 的 min_col / min_row / max_col / max_row 是否与数据实际位置匹配。表头行通常需要 titles_from_data=True。

Q3：中文字符显示为方框？

A：字体不支持中文。设置 Font(name='微软雅黑') 或 Font(name='SimSun') 显式指定中文字体。

Q4：公式写入后 Excel 不计算？

A：openpyxl 只写入公式字符串，不计算结果。Excel 打开时会自动重算；如需预先计算，需调用 LibreOffice --headless 或使用 xlwings。

Q5：合并单元格后只有左上角可写入？

A：这是 Excel 的设计——合并范围内只有左上角单元格保留值。写入时定位到左上角即可。

依赖说明

运行环境

• Agent 平台：支持 SKILL.md 的任意 AI Agent（Claude Code / Cursor / Codex / Gemini CLI 等）
• 操作系统：Windows / macOS / Linux
• Python：3.8+
• 办公软件：Excel / WPS / LibreOffice 任一，用于打开生成的文件

第三方依赖

API Key 配置

• 本 Skill 基于本地 Python 与 openpyxl，无需额外 API Key
• 不涉及网络调用与外部端点
• 所有数据在本地处理，不上传任何服务器
• 禁止在 SKILL.md 或脚本中硬编码任何密钥或 Token

可用性分类

• 分类：MD+EXEC（纯 Markdown 指令，部分功能需要 exec 命令行执行能力）
• 说明：基于 Markdown 的 AI Skill，通过自然语言指令驱动 Agent 生成 Python 脚本并执行

已知限制

本免费体验版限制以下高级功能：

• 批量生成（一次仅生成单个文件）
• 多文件合并与拆分
• 条件格式与数据验证规则
• 高级图表（散点图、瀑布图、组合图）
• 自定义模板系统与变量插值
• 跨平台深度格式优化（仅保证 Excel 兼容）
• 数据源对接（数据库、API）
• 优先技术支持

解锁全部功能请使用专业版：excel-craft-pro

• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

错误处理

示例

基本用法

输入：用户提供操作指令和必要参数

输出：返回执行结果,包含操作状态和输出数据

用户: 执行核心功能
Skill: 正在执行核心功能...
Skill: 执行完成,结果如下: 操作成功

输出格式

{
  "success": true,
  "data": {
    "result": "Excel工艺免费版处理结果",
    "execution_time": "0.5s",
    "metadata": {
      "version": "1.0",
      "processor": "excel craft"
    }
  },
  "execution_log": ["解析输入参数", "执行核心处理", "格式化输出结果"],
  "error": null
}