# Word Processor

> Create and edit Word documents (.docx) using python-docx. Supports formatting, tables, images, headers, and template-based generation.

- Skill: `malue-ai/word-processor` (Agent Skill)
- Install (CLI): `npx skillmds@latest add malue-ai/word-processor`
- Raw SKILL.md: https://api.skillmd.com/api/skills/malue-ai/word-processor/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: malue-ai (https://skillmd.com/u/malue-ai)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/malue-ai/word-processor

---


# Word 文档处理

使用 python-docx 创建和编辑 Word 文档（.docx）。

## 使用场景

- 用户说「帮我生成一份 Word 报告」「把这些内容写成 Word」
- 用户需要创建格式化的文档（标题、表格、列表）
- 用户需要修改现有 Word 文件

## 依赖安装

```bash
pip install python-docx
```

## 创建文档

```python
from docx import Document
from docx.shared import Inches, Pt, Cm
from docx.enum.text import WD_ALIGN_PARAGRAPH

doc = Document()

# 标题
doc.add_heading('报告标题', level=0)

# 段落
p = doc.add_paragraph('这是正文内容。')
p.alignment = WD_ALIGN_PARAGRAPH.JUSTIFY

# 加粗和斜体
p = doc.add_paragraph()
p.add_run('加粗文本').bold = True
p.add_run('，')
p.add_run('斜体文本').italic = True

# 列表
doc.add_paragraph('要点一', style='List Bullet')
doc.add_paragraph('要点二', style='List Bullet')

# 编号列表
doc.add_paragraph('第一步', style='List Number')
doc.add_paragraph('第二步', style='List Number')

# 表格
table = doc.add_table(rows=3, cols=3, style='Table Grid')
table.cell(0, 0).text = '姓名'
table.cell(0, 1).text = '部门'
table.cell(0, 2).text = '职位'

# 分页
doc.add_page_break()

# 保存
output_path = '/tmp/report.docx'
doc.save(output_path)
print(f'文档已保存: {output_path}')
```

## 读取文档

```python
from docx import Document

doc = Document('/path/to/input.docx')

# 读取所有段落
for para in doc.paragraphs:
    print(f'[{para.style.name}] {para.text}')

# 读取表格
for table in doc.tables:
    for row in table.rows:
        print([cell.text for cell in row.cells])
```

## 修改文档

```python
from docx import Document

doc = Document('/path/to/input.docx')

# 修改段落文本
for para in doc.paragraphs:
    if '旧内容' in para.text:
        for run in para.runs:
            run.text = run.text.replace('旧内容', '新内容')

doc.save('/path/to/output.docx')
```

## 输出规范

- 默认保存到 `/tmp/` 或用户指定路径
- 生成后告知用户文件路径
- 如果在 macOS 上，用 `open` 命令打开文件预览