Office 自动化技能

使用 Python 脚本自动化处理 Word (.docx) 和 Excel (.xlsx/xlsm) 文件。

快速开始

1. 安装依赖

pip install python-docx openpyxl pandas

2. 基本用法

处理 Word 文档：

python scripts/word_processor.py read document.docx
python scripts/word_processor.py write output.docx --content "Hello World"
python scripts/word_processor.py template fill.docx --data '{"name": "张三", "date": "2026-02-22"}'

处理 Excel 表格：

python scripts/excel_processor.py read data.xlsx
python scripts/excel_processor.py write output.xlsx --sheet "Sheet1"
python scripts/excel_processor.py merge folder/ --output merged.xlsx

脚本说明

word_processor.py

命令	说明	示例
`read`	读取 Word 文档内容	`read file.docx`
`write`	创建新文档	`write out.docx --content "文本"`
`template`	填充模板（替换 {{变量}}）	`template doc.docx --data '{"key": "value"}'`
`extract`	提取表格到 CSV	`extract file.docx --table 1`
`format`	格式化文档	`format file.docx --style heading`

excel_processor.py

命令	说明	示例
`read`	读取 Excel 数据	`read data.xlsx --sheet Sheet1`
`write`	写入数据到 Excel	`write out.xlsx --data data.json`
`merge`	合并多个 Excel 文件	`merge folder/ --output all.xlsx`
`convert`	Excel ↔ CSV 转换	`convert file.xlsx --to csv`
`analyze`	数据分析（统计、透视）	`analyze sales.xlsx --pivot`

使用场景

Word 处理

📝 批量生成报告/合同
📋 填充模板文档
📊 提取文档中的表格数据
🎨 统一文档格式

Excel 处理

📈 数据汇总和合并
🔄 格式转换（Excel ↔ CSV）
📊 数据分析和统计
📋 批量处理多个表格

注意事项

Word 格式：仅支持 .docx 格式（不支持旧版 .doc）
Excel 格式：支持 .xlsx 和 .xlsm
编码：默认使用 UTF-8 编码
大文件：超过 100MB 的文件建议分批次处理

脚本位置

所有脚本位于 skills/office-automation/scripts/ 目录。

使用时请确保从技能目录或 workspace 根目录运行。