office-document-editor

Office Document Editor

Edit existing Office documents (PPTX, DOCX, XLSX) in the project space using direct file manipulation.

When To Use

Use this Skill when the user wants to:

• 修改现有 PPT 的页面内容、标题、数据
• 更新 Word 文档的段落、章节、表格
• 修改 Excel 的单元格、公式、行列
• 给现有文档添加/删除内容
• 修复格式问题

Do NOT use this Skill for creating brand new files. For new file creation, use write_project_office_document directly.

Tools

Tool	Purpose
read_project_file	Read existing file content to understand structure
edit_project_office_document	Apply edits to existing PPTX/DOCX/XLSX files
write_project_office_document	Only used when creating a new file from scratch

Workflow

1. Read    → read_project_file to understand file structure
2. Plan    → Identify what needs to change
3. Edit    → edit_project_office_document with specific edits
4. Confirm → Report changes to user

Step 1: Read the Existing File

Always read the file first to understand its structure:

read_project_file(project_id=X, action='read', file_id=Y)

• PPTX: Returns slide-by-slide text with titles, body, layout info
• DOCX: Returns section headings, paragraph text, table content
• XLSX: Returns sheet names, cell values, structure

Step 2: Plan Modifications

After reading, outline the changes clearly:

修改计划：
- 第 3 页：标题从 "XXX" 改为 "YYY"
- 第 5 页：更新 body text
- Excel Sheet1：更新 B2:B10 的数据

Step 3: Apply Edits

Use edit_project_office_document to apply changes directly to the file.

PPTX Edit Actions

update_slide — Update slide title and/or content

{
  "file_id": 123,
  "edits": [
    {
      "action": "update_slide",
      "slide_index": 2,
      "title": "New Slide Title",
      "content": "- Point 1\n- Point 2\n- Point 3"
    }
  ]
}

update_text — Replace specific text on a slide

{
  "file_id": 123,
  "edits": [
    {
      "action": "update_text",
      "slide_index": 2,
      "old_text": "2023年数据",
      "new_text": "2024年数据"
    }
  ]
}