excel-toolkit/SKILL.md

name	description	metadata
excel-toolkit	Excel 文件智能处理工具，支持读取、合并、编辑、筛选、翻译等操作	openclaw requires install bins uv kind label uv Install uv

Excel Toolkit - Excel 文件智能处理

⚠️ 调用方式（必须遵守）

所有脚本必须通过 {baseDir}/run.sh 执行，确保使用 uv 虚拟环境：

{baseDir}/run.sh <script_name> [args...]

不要直接使用 python scripts/xxx.py，会污染系统环境！

可用脚本

脚本	功能	示例
read_excel	读取 Excel/CSV	./run.sh read_excel --file data.xlsx
merge_excel	合并多个文件	./run.sh merge_excel --files a.xlsx b.xlsx
replace_cells	替换内容	./run.sh replace_cells --file data.xlsx --old "旧" --new "新"
filter_data	筛选排序	./run.sh filter_data --file data.xlsx --column "姓名" --value "张三"
batch_process	批量处理	./run.sh batch_process --dir ./files --replace "旧|新"
translate_excel	翻译中→英	./run.sh translate_excel --file data.xlsx
auto_script	自扩展	./run.sh auto_script --prompt "计算每列总和"

核心功能

1. 基础文件操作

• 读取 Excel 文件（.xlsx, .csv）
• 创建新的 Excel 文件
• 保存和导出

2. 合并功能

• 按行合并多个文件
• 按列合并多个文件
• 合并同一文件中的多个 sheet

3. 数据处理

• 单元格内容替换
• 批量替换（支持正则表达式）
• 数据筛选、排序、去重

4. 翻译功能

• 中文→英文翻译（Google Gemini API）
• 智能检测中文字符
• 保留原始格式

5. 自扩展功能

• 根据自然语言需求自动生成脚本
• 模板复用 + 智能缓存

依赖管理

cd {baseDir}

# 同步依赖
uv sync

# 添加新包
uv add <package-name>

环境变量

# Google Gemini API Key（翻译功能需要）
export GEMINI_API_KEY="your-api-key"