office-documents

Files (1)

• SKILL.md

SKILL.md (first lines)

# Office Documents — Word / Excel / PDF / PPT 文档处理

处理四种主流办公文档格式的统一技能包。

## 使用场景

✅ **以下情况使用此技能：**

- 用户要求生成 Word 报告或文档
- 需要读取、写入、分析 Excel 数据
- 需要合并、拆分、提取 PDF 内容
- 需要创建或修改 PPT 演示文稿

## 不适用场景

❌ **不使用此技能：**

- 纯文本文件读写 → 改用 `file_system_op`
- 抓取网页内容 → 改用 `web_fetch`
- 执行数据分析脚本 → 改用 `python_interpreter`（但可以先用 `excel_op` 读数据）

## 可用工具

| 工具 | 用途 | 常用操作 |
|------|------|---------|
| `office_docx_write` | Word 文档生成 | 写入报告、公文、合同等格式化文档 |
| `excel_op` | Excel 表格操作 | read（读取数据）、write（写入数据）、analyze（分析） |
| `pdf_op` | PDF 处理 | read（提取文本）、merge（合并）、split（拆分） |
| `pptx_op` | PPT 演示文稿 | 创建幻灯片、插入文本/图片 |

## 标准工作流

### Word 文档生成

```
步骤 1：确认文档内容和格式要求
步骤 2：office_docx_write(title="标题", content=[...], output_path="...")
  → 支持标题层级、段落、列表、表格等富文本元素
步骤 3：file_system_op(action="read", path="...") 验证输出
```

### Excel 数据处理

```
步骤 1：读取数据
  excel_op(action="read", path="data.xlsx")
步骤 2：用 python_interpreter 处理数据（pandas/matplotlib）
步骤 3：写回结果
  excel_op(action="write", path="result.xlsx", data=<处理后的数据>)
```

### PDF 操作

```
读取：pdf_op(action="read", path="file.pdf")
合并：pdf_op(action="merge", paths=["a.pdf", "b.pdf"], output_path="merged.pdf")
拆分：pdf_op(action="split", path="file.pdf", page_ranges="1-3,5-7")
```

### PPT 生成

```
pptx_op(action="create", title="演示标题", slides=[...], output_path="...")
```

## 关键原则

- **先读再写**：修改现有文件时，先用 read 操作确认文件内容和结构。
- **绝对路径**：所有路径参数使用绝对路径，确保文件定位准确。
- **中文排版**：生成中文 Word 文档时，遵循公文格式规范（标题用方正小标宋、正文用仿宋）。
- **大数据处理**：Excel 数据量较大时，优先使用 `python_interpreter` + pandas 处理，效率更高。

## 注意事项

- Word 文档生成支持多种段落样式，但复杂排版可能需要通过 `python_interpreter` 直接调用 python-docx 库获得更精细控制。
- PDF 读取对扫描件（图片 PDF）效果有限，如需 OCR 请配合 `ocr_extract` 工具。
- Excel 文件较大时（>10MB），建议先用 `file_system_op(action="hash")` 确认文件完整性。

From zzycxz/rooster, MIT.

More from zzycxz/rooster