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年数据"
    }
  ]
}

add_slide — Add a new slide

{
  "file_id": 123,
  "edits": [
    {
      "action": "add_slide",
      "layout_index": 1,
      "title": "New Section Title",
      "content": "- Content line 1\n- Content line 2"
    }
  ]
}

delete_slide — Delete a slide by index

{
  "file_id": 123,
  "edits": [
    {"action": "delete_slide", "slide_index": 4}
  ]
}

DOCX Edit Actions

update_text — Replace text throughout the document

{
  "file_id": 456,
  "edits": [
    {
      "action": "update_text",
      "old_text": "旧公司名称",
      "new_text": "新公司名称"
    }
  ]
}

replace_paragraph — Replace all content under a heading

{
  "file_id": 456,
  "edits": [
    {
      "action": "replace_paragraph",
      "heading": "第二章 市场分析",
      "content": "Updated market analysis content...\nSecond paragraph..."
    }
  ]
}

add_paragraph — Add content after a heading

{
  "file_id": 456,
  "edits": [
    {
      "action": "add_paragraph",
      "after_heading": "结论",
      "content": "新增的风险分析段落..."
    }
  ]
}

XLSX Edit Actions

update_cell — Update a single cell

{
  "file_id": 789,
  "edits": [
    {
      "action": "update_cell",
      "sheet": "Sheet1",
      "cell": "B2",
      "value": 15000
    }
  ]
}

update_cells — Update multiple cells at once

{
  "file_id": 789,
  "edits": [
    {
      "action": "update_cells",
      "sheet": "Sheet1",
      "updates": {
        "B2": 15000,
        "B3": 23000,
        "C2": "=B2*1.1"
      }
    }
  ]
}

update_row — Replace an entire row

{
  "file_id": 789,
  "edits": [
    {
      "action": "update_row",
      "sheet": "Sheet1",
      "row": 5,
      "values": ["Q2", 15000, 23000, 38000]
    }
  ]
}

add_row — Insert or append a row

{
  "file_id": 789,
  "edits": [
    {
      "action": "add_row",
      "sheet": "Sheet1",
      "after_row": 10,
      "values": ["Total", "=SUM(B2:B10)"]
    }
  ]
}

delete_row — Delete a row

{
  "file_id": 789,
  "edits": [
    {"action": "delete_row", "sheet": "Sheet1", "row": 11}
  ]
}

add_sheet — Add a new worksheet

{
  "file_id": 789,
  "edits": [
    {"action": "add_sheet", "name": "Summary"}
  ]
}

Saving Behavior

• Default: Overwrites the original file
• New copy: Provide output_name to save as a new file instead of overwriting

{
  "file_id": 123,
  "output_name": "报告_修改版.pptx",
  "edits": [...]
}

Important Rules

1. Always read before editing — Never guess the content of an existing file
2. Use slide_index correctly — PPTX slide indices are 0-based (first slide = 0)
3. Preserve structure — Don't break the document's logical structure
4. Confirm destructive changes — If overwriting the original, confirm with user
5. Name clearly — Use output_name for edited copies (e.g., "报告_修改版.pptx")

Modification Patterns

Pattern 1: Single Slide Edit

User: "把 PPT 第 3 页的标题改一下" → read_project_file → edit_project_office_document(action=update_slide, slide_index=2)

Pattern 2: Data Update

User: "把 Excel 里的 2024 年数据更新一下" → read_project_file → edit_project_office_document(action=update_cells, updates={...})

Pattern 3: Add Content

User: "在 Word 的结论后面加一段风险分析" → read_project_file → edit_project_office_document(action=add_paragraph, after_heading="结论")

Pattern 4: Replace Text

User: "把 PPT 里所有的 '旧公司' 改成 '新公司'" → read_project_file → edit_project_office_document(action=update_text, old_text="旧公司", new_text="新公司")

Pattern 5: Create Edited Copy

User: "基于这个 PPT 做一个修改版，不要改原文件" → read_project_file → edit_project_office_document(output_name="修改版.pptx", edits=[...])

Capability Upgrade

Mode Selection

• Quick: 执行明确的单点修改，如替换文字、改标题或更新单页。
• Standard: 执行多处结构化编辑，并保留原格式和可追踪说明。
• Deep: 结合用户意图、文档结构、品牌格式、内容逻辑和版本管理，生成可交付修订版。

Editing Decision Logic

先判断用户要“改内容、改结构、改格式、改数据、改风格还是创建副本”。不同意图对应不同编辑策略；不明确时优先创建副本，避免破坏原文件。

Quality Gates

• 明确是否修改原文件或创建副本。
• 保留原有版式、编号、表格和图片位置。
• 多处替换前确认大小写、全角半角和语境。
• 对 PPT/Word/Excel 分别检查格式和数据一致性。
• 输出说明修改了哪些位置，便于用户复核。

Deliverable Catalog

Deliverable	When to use	Minimum content	Format
Edited document copy	修改正式文件	新文件、修改内容、保留格式和修改摘要	DOCX / PPTX / XLSX
Change summary	用户复核	文件、位置、原内容、新内容、原因和影响	Markdown
Redline-style revision note	需要审阅	修改点、建议、风险、待确认问题	Word / Markdown
PPT update package	修改演示文稿	页码、标题、内容、图表、备注和版式检查	PPTX
Excel update package	修改表格	sheet、单元格、公式、数据源和校验结果	XLSX
Document QA checklist	交付前	格式、编号、链接、图片、表格、公式和版本	Checklist