办公文档专家

技能文档

---
name: office-pro
title: 办公文档专家
category: 办公效率
description: 企业级文档自动化套件，一键生成专业 Word 合同和 Excel 报表，内置 10 种合同模板、6 种 Excel 模板和报告模板，无需外部模板文件。当用户需要快速生成合同文档、数据报表、会议纪要或日常办公文件时使用。触发词：生成合同、Word文档、Excel报表、办公自动化、报表生成、会议纪要。
---

# 办公文档专家 - 企业级文档自动化套件

一键生成专业合同与报表的文档生成工具，内置完整条款与模板，无需外部模板文件。

## 核心功能

- **一键生成**：无需外部模板文件，内置完整条款
- **合同模板**：10 种专业合同（车位租赁、房屋租赁、劳动合同等）
- **Excel 模板**：6 种报表模板（财务报表、项目进度、员工花名册等）
- **报告模板**：会议纪要、工作报告
- **高级功能**：Excel 图表、Word 高级样式（可选）

## 技能工作流

接收用户的文档生成需求 → 识别文档类型与参数 → 调用生成接口产出文件 → 校验输出并交付

### 步骤1：安装依赖

首次使用前确认 Python 环境已安装所需依赖：

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

### 步骤2：识别文档类型与模板

根据用户需求选择模板类别与 ID：

**合同模板（10 种）**

| ID | 名称 | ID | 名称 |
|---|------|---|------|
| `parking_lease` | 车位租赁合同 | `sales` | 销售合同 |
| `house_lease` | 房屋租赁合同 | `service` | 服务合同 |
| `labor` | 劳动合同 | `purchase` | 采购合同 |
| `nda` | 保密协议 | `cooperation` | 合作协议 |
| `loan` | 借款合同 | `commission` | 委托合同 |

**Excel 模板（6 种）**

| ID | 名称 |
|---|------|
| `financial_report` | 财务报表 |
| `project_schedule` | 项目进度表 |
| `employee_roster` | 员工花名册 |
| `asset_inventory` | 资产清单 |
| `expense_report` | 费用报销单 |
| `invoice` | 发票管理表 |

**报告模板（2 种）**

| ID | 名称 |
|---|------|
| `meeting_minutes` | 会议纪要 |
| `work_report` | 工作报告 |

也可用 `list_templates` 接口列出全部可用模板（见步骤5）。

### 步骤3：收集生成参数

从用户需求中提取参数，缺失时向用户确认：

- 合同：甲乙方名称、地点、金额（如月租）、起止日期等
- Excel：公司名称等
- 报告：会议标题/日期，或报告人姓名

输出文件名可省略，未指定时自动命名。

### 步骤4：调用生成接口产出文档

在技能目录下通过 Python 调用统一入口：

```python
from office_pro import generate_contract, generate_excel, generate_report

# 生成车位租赁合同
generate_contract('parking_lease',
    party_a='张三', party_b='李四',
    location='XX小区地下停车场',
    space_number='A-123',
    monthly_rent=500,
    start_date='2024-01-01',
    end_date='2024-12-31'
)

# 生成财务报表
generate_excel('financial_report', company_name='XX公司')

# 生成会议纪要
generate_report('meeting_minutes',
    meeting_title='Q1规划会议',
    meeting_date='2024-03-15'
)
```

各接口的完整入参/出参 Schema 见 [references/api-schema.md](references/api-schema.md)。

### 步骤5：列出模板（可选）

```python
from office_pro import list_templates

list_templates()                # 全部模板
list_templates('contract')      # 仅合同类
```

### 步骤6：交付与高级处理（可选）

生成成功后返回输出路径给用户。需要进一步美化时可使用高级功能：

```python
from office_pro import create_chart, create_styled_document

# Excel 图表
create_chart('report.xlsx') \
    .add_bar_chart('Sheet1', 'A1:B10', '销售数据') \
    .save()

# Word 高级样式
create_styled_document() \
    .add_styled_heading('报告', color='1F4E79') \
    .add_table_with_style([['项目', '金额'], ['收入', '100万']]) \
    .save('report.docx')
```

## 接口参数速查

### generate_contract（生成合同）

必填：`contract_type`（模板 ID）。常用可选：`party_a`、`party_b`、`location`、`monthly_rent`、`start_date`、`end_date`、`output`（输出文件名）。

### generate_excel（生成 Excel 报表）

必填：`excel_type`（模板 ID）。可选：`company_name`、`output`。

### generate_report（生成报告）

必填：`report_type`（`meeting_minutes` 或 `work_report`）。可选：`meeting_title`、`meeting_date`、`reporter`、`output`。

## 许可协议

MIT License

使用说明

# 办公文档专家

企业级文档自动化套件，一键生成专业 Word 合同和 Excel 报表，内置 10 种合同模板、6 种 Excel 模板和报告模板，无需外部模板文件。

## 使用

安装依赖：

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

最简用法：

```python
from office_pro import generate_contract, generate_excel, generate_report

# 生成车位租赁合同
generate_contract('parking_lease',
    party_a='张三', party_b='李四',
    monthly_rent=500,
    start_date='2024-01-01', end_date='2024-12-31'
)

# 生成财务报表
generate_excel('financial_report', company_name='XX公司')

# 生成会议纪要
generate_report('meeting_minutes', meeting_title='Q1规划会议', meeting_date='2024-03-15')
```

## 工作原理

技能以 Python 包形式提供统一生成入口，内置合同、Excel、报告三类模板的完整条款与样式定义。调用生成函数时按模板 ID 选择模板、填充传入参数后，通过 python-docx / openpyxl 直接输出 .docx / .xlsx 文件并返回输出路径。可选高级接口支持 Excel 图表与 Word 高级样式。

如何安装此技能？

访问技能市场，点击「安装」按钮，按提示将技能包放入 AI 编程助手的 skills 目录即可。