Docx Generation

SKILL.md

---
name: docx-generation
author: 王教成 Wang Jiaocheng (波动几何)
description: Word文档生成技能，支持从零创建专业Word文档，包含完整设计规范、模板系统和内容生成能力。触发词：生成Word文档、创建docx、Word文档生成、制作Word、docx生成、meta-skill-system
---

# Word文档生成技能

## 定位

本技能提供从设计规范到文档输出的完整能力。

**输出形式**：生成.docx格式的Word文档，用户可直接使用Microsoft Word或其他兼容软件打开编辑。

## 核心能力

### 设计规范能力

内置完整的视觉设计规范，确保生成的文档风格统一、专业：

- **颜色系统**：9色系×7层级的完整调色板，支持亮色/暗色模式
- **字体系统**：标题/正文/辅助文字的大小、字重、行高规范
- **布局系统**：页边距、段落间距、行距、页眉页脚规范
- **样式系统**：预设样式（标题/正文/列表/表格/图片等）
- **文档类型指导**：报告、方案、合同、简历等文档的排版规范

### 内容生成能力

生成结构化文档内容，满足不同场景需求：

- **结构化内容**：章节、段落、列表、表格
- **格式化元素**：标题、正文、引用、注释
- **嵌入对象**：图片、图表、超链接
- **页面元素**：页眉、页脚、页码、目录

### 模板应用能力

基于模板快速生成文档，保持风格一致：

- **内置模板**：报告、方案、合同、简历等常用模板
- **自定义模板**：支持用户自定义模板
- **样式继承**：从模板继承样式和格式

### 输出保存能力

支持多种输出选项，满足不同使用场景：

- **标准输出**：.docx格式，兼容Microsoft Word
- **格式保持**：保持所有格式和样式
- **版本兼容**：支持不同Word版本

## 使用规则

### 执行流程

1. **首次加载**：读取 `references/docx-catalog.md`，获取设计规范和组件清单
2. **按需深入**：确认文档类型后，读取 `references/docx-requirements.md` 获取生成要求；如需范本，读取 `references/exemplars.md` 获取参考
3. **独立执行**：本技能不依赖外部工具，所有能力均已内嵌，可直接生成文档代码

### 格式选择规则

根据用户需求选择合适的输出格式：

| 需求场景 | 推荐格式 | 原因 |
|----------|----------|------|
| 正式文档 | .docx | 标准格式，兼容性好 |
| 快速生成 | 模板应用 | 效率高，风格统一 |
| 复杂排版 | 自定义样式 | 灵活性强 |

### 输出规则

1. **文件输出**：生成的文档保存为 `.docx` 文件
2. **软件查看**：用户可通过Microsoft Word或其他兼容软件打开文档
3. **格式保持**：确保所有格式和样式正确显示

## 执行框架

本技能内嵌了完整的文档生成执行框架。

**核心理念**：
- **规范驱动**：所有文档必须遵循设计规范
- **内容适配**：根据需求选择最合适的内容结构
- **用户友好**：输出文件可直接使用，无需额外处理

**统一执行流程**：收到任务后按4步执行——需求分析 → 内容规划 → 文档生成 → 文件输出。

### Step 0：需求分析

分析用户的文档需求：
- 文档类型（报告/方案/合同/简历）
- 内容复杂度（简单/中等/复杂）
- 格式要求（正式/非正式）
- 保存需求（是否需要特定格式）

### Step 1：内容规划

根据需求分析结果规划内容：
- **结构规划**：章节、段落、列表
- **内容规划**：标题、正文、表格、图片
- **样式规划**：字体、颜色、间距

### Step 2：文档生成

根据设计规范生成文档内容：
- 应用颜色系统（选择合适的色系和层级）
- 应用字体系统（标题/正文/辅助文字）
- 应用布局规则（页边距、段落间距、行距）
- 应用样式系统（预设样式类）

### Step 3：文件输出

将生成的文档保存为文件：
- Word文件：`.docx` 扩展名
- 告知用户文件位置和打开方式

## Word文档特有维度

| 维度 | 说明 | 影响 |
|------|------|------|
| **文档类型** | 报告、方案、合同、简历等 | 决定内容结构和样式选择 |
| **格式规范** | 正式、非正式、学术等 | 影响字体、间距、排版风格 |
| **内容结构** | 章节、段落、列表、表格 | 决定文档组织方式 |
| **嵌入对象** | 图片、图表、超链接 | 影响文档复杂度和生成方式 |

## 三层结构

第一层：文档生成清单 + 依赖拓扑 → references/docx-catalog.md
第二层：文档生成要求清单 → references/docx-requirements.md
第三层：文档生成范本库 → references/exemplars.md

## 文档生成域概览

| 域 | 任务数 | 典型任务 |
|----|--------|---------|
| D0 需求分析域 | 4 | 文档类型识别、内容复杂度评估、格式要求分析、输出格式选择 |
| D1 设计规范域 | 4 | 颜色系统应用、字体系统应用、布局规则应用、样式系统应用 |
| D2 内容生成域 | 4 | 结构化内容生成、格式化元素生成、嵌入对象生成、页面元素生成 |
| D3 格式处理域 | 4 | 样式应用、格式调整、排版优化、兼容性处理 |
| D4 输出保存域 | 3 | Word文件输出、格式验证、版本兼容处理 |

**域间逻辑流**：D0 → D1 → D2/D3 → D4（按需调用）

完整清单见 `references/docx-catalog.md`。

## 事实纪律

1. 设计规范必须来自 `references/docx-catalog.md`，不可凭感觉
2. 生成的文档必须符合规范要求，不可随意修改样式
3. 文件输出必须使用标准格式，确保软件兼容性
4. 复杂文档必须使用成熟的文档库，不可自行实现复杂逻辑
5. 格式保持功能必须使用标准API，不可依赖第三方服务

## 标题层级规范

为确保合并为单一提示词文件时标题层级不冲突，各文件标题层级规范如下：

| 文件类型 | 一级标题 | 二级标题 | 三级标题 | 四级标题 |
|---------|---------|---------|---------|---------|
| SKILL.md | `#` | `##` | `###` | `####` |
| references/catalog.md | `##` | `###` | `####` | `#####` |
| references/requirements.md | `##` | `###` | `####` | `#####` |
| references/exemplars.md | `##` | `###` | `####` | `#####` |
| references/exemplars/*.md | `##` | `###` | `####` | `#####` |