# DOCX Generation

> Word 文档生成技能。当需要将监测报告、技术方案或投标文件导出为正式 .docx 文件时加载此技能，获取排版规范、章节结构和工具调用指引。

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

---


## 适用场景

- 监测日报/周报/月报导出为 Word 文件
- 技术方案书定稿输出
- 投标技术标文件排版
- 工程勘察报告正式版导出
- 任何需要提交给业主、监理或政府审批的正式文档

## 核心工作流

```
1. 内容准备 → 2. Markdown 排版 → 3. 调用 report_export 工具 → 4. 确认输出
```

### 步骤详解

**第一步：内容准备**
确保报告内容已经过完整的编制流程（`technical_writer` 撰写 + `qa_reviewer` 审核通过）。未经审核的内容禁止直接导出。

**第二步：Markdown 排版**
将最终审核通过的内容整理为标准 Markdown 格式。`report_export` 工具支持以下 Markdown 元素：

| 元素 | 语法 | 导出效果 |
|------|------|---------|
| 一级标题 | `# 标题` | Word 标题1（加粗，16pt） |
| 二级标题 | `## 标题` | Word 标题2（加粗，14pt） |
| 三级标题 | `### 标题` | Word 标题3（加粗，12pt） |
| 加粗 | `**文字**` | Word 加粗 |
| 无序列表 | `- 项目` | Word 项目符号列表 |
| 有序列表 | `1. 项目` | Word 编号列表 |
| 引用块 | `> 内容` | Word 引用段落（左缩进+灰色竖线） |
| 普通段落 | 直接文字 | Word 正文（宋体/仿宋，12pt） |

**第三步：调用工具**
```
调用 report_export 工具，传入参数：
- markdown: 完整的 Markdown 报告正文
- title: 文档标题（将作为文件名）
- outputPath: 可选，指定输出路径
```

**第四步：确认输出**
工具返回文件路径和统计信息后，向用户报告导出结果。

## 排版规范（国企/甲方交付标准）

### 文件命名

格式：`[项目简称]-[文档类型]-[日期].docx`

示例：
- `望京SOHO基坑-监测日报-20250301.docx`
- `地铁16号线-第三方监测月报-202502.docx`
- `中关村大厦-变形监测总结报告.docx`

### 报告头部必备要素

每份正式报告必须包含以下信息（作为 Markdown 正文开头）：

```markdown
# [项目全称] [报告类型]

**报告编号**：RW-[年份]-[项目编码]-[序号]
**委托单位**：[甲方名称]
**监测单位**：深圳市睿威智测科技有限公司
**编制日期**：[年月日]

---
```

### 页面结构

| 部分 | 说明 |
|------|------|
| 封面信息 | 项目名称、报告类型、编号、日期、编制单位 |
| 目录提示 | 在正文前写一行 `> 注：正式提交时请在 Word 中插入自动目录` |
| 正文章节 | 按标题层级组织 |
| 附件说明 | 在报告末尾注明需附的图纸和数据表 |

## 常见文档类型模板

### 监测日报

```markdown
# [项目名称] 第三方监测日报

**报告编号**：RW-2025-XXX-NNN
**监测日期**：2025年XX月XX日
**天气**：晴，气温15～22℃

---

## 1. 本日监测概况

[概况文字]

## 2. 监测成果

### 2.1 [监测项目]

[数据表格，使用 Markdown 表格]

## 3. 预警情况

[预警或"本日无预警"]

## 4. 结论与建议

[结论]
```

### 技术方案

```markdown
# [项目名称] 自动化监测技术方案

## 1. 项目概况
## 2. 编制依据
## 3. 监测内容与方法
### 3.1 监测项目
### 3.2 测点布设
### 3.3 仪器设备
## 4. 监测频率
## 5. 预警值与控制标准
## 6. 数据处理与信息化
## 7. 质量保证措施
## 8. 安全保障措施
## 9. 人员与设备配置
```

## 注意事项

- `report_export` 工具生成的是基础排版的 Word 文件，复杂格式（页眉页脚、公司 Logo、签章栏）需用户在 Word 中手动调整
- 表格数据量大时（超过 20 行），建议使用 `excel_export` 工具导出 Excel 附件，报告正文仅保留摘要表
- 图表（趋势图等）需先用 `chart_generator` 工具生成 SVG，再由用户手动插入 Word
- 文件默认输出到当前工作目录，可通过 `outputPath` 参数指定其他路径