DOCX 生成器 - 自动化 Word 文档生成与模板替换工具 | Deno 技能

docx-generator by jwynia/agent-skills

291 周安装量

37 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/jwynia/agent-skills --skill docx-generator

办公软件开发自动化

🇨🇳中文介绍

DOCX 生成器

何时使用此技能

在以下情况下使用此技能：

根据数据或规范以编程方式创建 Word 文档
使用动态内容填充品牌模板，同时保留企业样式
从现有 DOCX 文件中提取文本、表格和结构以进行分析
查找并替换占位符文本，如 {{TITLE}} 或 ${author}
自动化文档生成工作流（报告、合同、信件等）

在以下情况下不要使用此技能：

用户想要打开/查看文档（使用原生 Word 或查看器）
需要与数据源进行复杂的邮件合并（使用原生 Word 邮件合并）
处理旧的 .doc 格式（仅支持 DOCX）
需要 PDF 输出（请改用 pdf-generator 技能）

先决条件

已安装 Deno (https://deno.land/)
用于基于模板操作的输入 DOCX 文件
用于从头生成文档的 JSON 规范

快速开始

两种操作模式

模板模式：修改现有的品牌模板
- 分析模板以查找占位符
- 将 {{PLACEHOLDERS}} 替换为实际内容
：使用 JSON 规范从零开始创建文档

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

模式 1：基于模板生成

步骤 1a：分析模板

提取文本清单以了解可以替换的内容：

deno run --allow-read scripts/analyze-template.ts corporate-template.docx > inventory.json

输出 (inventory.json)：

{
  "filename": "corporate-template.docx",
  "paragraphCount": 25,
  "tableCount": 2,
  "imageCount": 1,
  "paragraphs": [
    {
      "index": 0,
      "style": "Title",
      "fullText": "{{DOCUMENT_TITLE}}",
      "runs": [
        { "text": "{{DOCUMENT_TITLE}}", "bold": true, "fontSize": 28 }
      ]
    }
  ],
  "placeholders": [
    { "tag": "{{DOCUMENT_TITLE}}", "location": "paragraph", "paragraphIndex": 0 },
    { "tag": "{{AUTHOR}}", "location": "footer-default", "paragraphIndex": 0 },
    { "tag": "${date}", "location": "table", "tableIndex": 0, "cellLocation": "R1C2" }
  ]
}

步骤 1b：创建替换规范

创建 replacements.json：

{
  "textReplacements": [
    { "tag": "{{DOCUMENT_TITLE}}", "value": "Q4 2024 Financial Report" },
    { "tag": "{{AUTHOR}}", "value": "Finance Department" },
    { "tag": "${date}", "value": "December 15, 2024" },
    { "tag": "{{COMPANY}}", "value": "Acme Corporation" }
  ],
  "includeHeaders": true,
  "includeFooters": true
}

步骤 1c：生成输出

deno run --allow-read --allow-write scripts/generate-from-template.ts \
  corporate-template.docx replacements.json output.docx

模式 2：从头生成

步骤 2a：创建规范

创建 spec.json：

{
  "title": "Quarterly Report",
  "creator": "Finance Team",
  "styles": {
    "defaultFont": "Calibri",
    "defaultFontSize": 11
  },
  "sections": [
    {
      "header": {
        "paragraphs": [
          { "text": "Acme Corporation", "alignment": "right" }
        ]
      },
      "footer": {
        "paragraphs": [
          { "text": "Confidential", "alignment": "center" }
        ]
      },
      "content": [
        {
          "text": "Q4 2024 Financial Report",
          "heading": 1,
          "alignment": "center"
        },
        {
          "runs": [
            { "text": "Executive Summary: ", "bold": true },
            { "text": "This report provides an overview of our financial performance for Q4 2024." }
          ]
        },
        { "pageBreak": true },
        {
          "text": "Revenue Breakdown",
          "heading": 2
        },
        {
          "rows": [
            {
              "cells": [
                { "content": [{ "text": "Category" }], "shading": "DDDDDD" },
                { "content": [{ "text": "Amount" }], "shading": "DDDDDD" },
                { "content": [{ "text": "Change" }], "shading": "DDDDDD" }
              ],
              "isHeader": true
            },
            {
              "cells": [
                { "content": [{ "text": "Product Sales" }] },
                { "content": [{ "text": "$1,250,000" }] },
                { "content": [{ "text": "+15%" }] }
              ]
            },
            {
              "cells": [
                { "content": [{ "text": "Services" }] },
                { "content": [{ "text": "$750,000" }] },
                { "content": [{ "text": "+8%" }] }
              ]
            }
          ],
          "width": 100,
          "borders": true
        }
      ]
    }
  ]
}

步骤 2b：生成文档

deno run --allow-read --allow-write scripts/generate-scratch.ts spec.json output.docx

示例 1：合同生成

场景：从品牌模板生成合同。

# 1. 分析模板以查找可替换内容
deno run --allow-read scripts/analyze-template.ts contract-template.docx --pretty

# 2. 使用客户数据创建 replacements.json
# 3. 生成合同
deno run --allow-read --allow-write scripts/generate-from-template.ts \
  contract-template.docx replacements.json acme-contract.docx

示例 2：包含表格的报告

场景：生成包含表格和格式的数据报告。

{
  "title": "Sales Report",
  "sections": [{
    "content": [
      { "text": "Monthly Sales Report", "heading": 1 },
      { "text": "January 2025", "heading": 2 },
      {
        "runs": [
          { "text": "Total Sales: ", "bold": true },
          { "text": "$125,000", "color": "2E7D32" }
        ]
      }
    ]
  }]
}

示例 3：包含页眉/页脚的信函

场景：创建带有信头的正式信函。

{
  "sections": [{
    "header": {
      "paragraphs": [
        { "text": "ACME CORPORATION", "alignment": "center", "runs": [{"text": "ACME CORPORATION", "bold": true, "fontSize": 16}] },
        { "text": "123 Business Ave, City, ST 12345", "alignment": "center" }
      ]
    },
    "content": [
      { "text": "December 15, 2024", "alignment": "right" },
      { "text": "" },
      { "text": "Dear Valued Customer," },
      { "text": "" },
      { "text": "Thank you for your continued business..." },
      { "text": "" },
      { "text": "Sincerely," },
      { "text": "John Smith" },
      { "runs": [{ "text": "CEO", "italic": true }] }
    ],
    "footer": {
      "paragraphs": [
        { "text": "www.acme.com | contact@acme.com", "alignment": "center" }
      ]
    }
  }]
}

脚本	用途	所需权限
`analyze-template.ts`	从 DOCX 中提取文本、表格、占位符	`--allow-read`
`generate-from-template.ts`	替换模板中的占位符	`--allow-read --allow-write`
`generate-scratch.ts`	根据 JSON 规范创建 DOCX	`--allow-read --allow-write`

属性	类型	描述
`text`	string	简单文本内容
`runs`	array	格式化文本片段（用于混合格式）
`heading`	1-6	标题级别
`alignment`	string	`left`, `center`, `right`, `justify`
`bullet`	boolean	项目符号列表项
`numbering`	boolean	编号列表项
`spacing`	object	`before`, `after`, `line` 间距
`indent`	object	`left`, `right`, `firstLine` 缩进
`pageBreakBefore`	boolean	在段落前插入分页符

属性	类型	描述
`text`	string	文本内容
`bold`	boolean	粗体格式
`italic`	boolean	斜体格式
`underline`	boolean	下划线格式
`strike`	boolean	删除线
`fontSize`	number	字体大小（磅值）
`font`	string	字体族名称
`color`	string	文本颜色（十六进制，不带 #）
`highlight`	string	高亮颜色
`superScript`	boolean	上标
`subScript`	boolean	下标

属性	类型	描述
`rows`	array	行规范数组
`width`	number	表格宽度百分比
`borders`	boolean	显示表格边框

属性	类型	描述
`text`	string	链接文本
`url`	string	目标 URL
`bold`	boolean	粗体格式
`italic`	boolean	斜体格式

常见问题与解决方案

问题：占位符未被替换

症状：输出 DOCX 仍包含 {{PLACEHOLDER}} 标签。

运行 analyze-template.ts 以验证确切的标签文本
标签可能跨 XML 片段分割——脚本会自动合并这些情况
如果占位符位于页眉/页脚，请确保 includeHeaders 和 includeFooters 为 true

问题：替换后格式丢失

症状：替换后的文本与原始格式不匹配。

文本替换会保留原始占位符的格式
确保占位符的格式符合您希望最终文本呈现的样子

问题：图片未显示

症状：输出文档中的图片元素为空白。

使用相对于 spec.json 文件位置的路径
验证图片文件存在且可读
检查支持的格式：PNG、JPEG、GIF

问题：表格单元格内容不正确

症状：表格单元格内容或格式错误。

每个单元格的 content 必须是段落规范数组
使用 shading 设置背景色，verticalAlign 设置对齐方式

仅支持 DOCX：不支持旧的 .doc 格式
无修订跟踪：无法添加或处理修订
无批注：无法添加文档批注
无宏：无法包含 VBA 宏
基本编号：对复杂编号方案的支持有限
文本片段分割：Word 可能会将文本跨 XML 元素分割；脚本处理常见情况

pptx-generator：用于创建 PowerPoint 演示文稿
xlsx-generator：用于创建 Excel 电子表格
pdf-generator：用于创建 PDF 文档

🇺🇸English

DOCX Generator

When to Use This Skill

Use this skill when:

Creating Word documents programmatically from data or specifications
Populating branded templates with dynamic content while preserving corporate styling
Extracting text, tables, and structure from existing DOCX files for analysis
Finding and replacing placeholder text like {{TITLE}} or ${author}
Automating document generation workflows (reports, contracts, letters)

Do NOT use this skill when:

User wants to open/view documents (use native Word or viewer)
Complex mail merge with data sources (use native Word mail merge)
Working with older .doc format (DOCX only)
PDF output is needed (use pdf-generator skill instead)

Prerequisites

Deno installed (https://deno.land/)
Input DOCX files for template-based operations
JSON specification for scratch generation

Quick Start

Two Modes of Operation

Template Mode : Modify existing branded templates
- Analyze template to find placeholders
- Replace {{PLACEHOLDERS}} with actual content
Scratch Mode : Create documents from nothing using JSON specifications

Instructions

Mode 1: Template-Based Generation

Step 1a: Analyze the Template

Extract text inventory to understand what can be replaced:

deno run --allow-read scripts/analyze-template.ts corporate-template.docx > inventory.json

Output (inventory.json):

{
  "filename": "corporate-template.docx",
  "paragraphCount": 25,
  "tableCount": 2,
  "imageCount": 1,
  "paragraphs": [
    {
      "index": 0,
      "style": "Title",
      "fullText": "{{DOCUMENT_TITLE}}",
      "runs": [
        { "text": "{{DOCUMENT_TITLE}}", "bold": true, "fontSize": 28 }
      ]
    }
  ],
  "placeholders": [
    { "tag": "{{DOCUMENT_TITLE}}", "location": "paragraph", "paragraphIndex": 0 },
    { "tag": "{{AUTHOR}}", "location": "footer-default", "paragraphIndex": 0 },
    { "tag": "${date}", "location": "table", "tableIndex": 0, "cellLocation": "R1C2" }
  ]
}

Step 1b: Create Replacement Specification

Create replacements.json:

{
  "textReplacements": [
    { "tag": "{{DOCUMENT_TITLE}}", "value": "Q4 2024 Financial Report" },
    { "tag": "{{AUTHOR}}", "value": "Finance Department" },
    { "tag": "${date}", "value": "December 15, 2024" },
    { "tag": "{{COMPANY}}", "value": "Acme Corporation" }
  ],
  "includeHeaders": true,
  "includeFooters": true
}

Step 1c: Generate Output

deno run --allow-read --allow-write scripts/generate-from-template.ts \
  corporate-template.docx replacements.json output.docx

Mode 2: From-Scratch Generation

Step 2a: Create Specification

Create spec.json:

{
  "title": "Quarterly Report",
  "creator": "Finance Team",
  "styles": {
    "defaultFont": "Calibri",
    "defaultFontSize": 11
  },
  "sections": [
    {
      "header": {
        "paragraphs": [
          { "text": "Acme Corporation", "alignment": "right" }
        ]
      },
      "footer": {
        "paragraphs": [
          { "text": "Confidential", "alignment": "center" }
        ]
      },
      "content": [
        {
          "text": "Q4 2024 Financial Report",
          "heading": 1,
          "alignment": "center"
        },
        {
          "runs": [
            { "text": "Executive Summary: ", "bold": true },
            { "text": "This report provides an overview of our financial performance for Q4 2024." }
          ]
        },
        { "pageBreak": true },
        {
          "text": "Revenue Breakdown",
          "heading": 2
        },
        {
          "rows": [
            {
              "cells": [
                { "content": [{ "text": "Category" }], "shading": "DDDDDD" },
                { "content": [{ "text": "Amount" }], "shading": "DDDDDD" },
                { "content": [{ "text": "Change" }], "shading": "DDDDDD" }
              ],
              "isHeader": true
            },
            {
              "cells": [
                { "content": [{ "text": "Product Sales" }] },
                { "content": [{ "text": "$1,250,000" }] },
                { "content": [{ "text": "+15%" }] }
              ]
            },
            {
              "cells": [
                { "content": [{ "text": "Services" }] },
                { "content": [{ "text": "$750,000" }] },
                { "content": [{ "text": "+8%" }] }
              ]
            }
          ],
          "width": 100,
          "borders": true
        }
      ]
    }
  ]
}

Step 2b: Generate Document

deno run --allow-read --allow-write scripts/generate-scratch.ts spec.json output.docx

Examples

Example 1: Contract Generation

Scenario : Generate contracts from a branded template.

Steps :

# 1. Analyze template for replaceable content
deno run --allow-read scripts/analyze-template.ts contract-template.docx --pretty

# 2. Create replacements.json with client data
# 3. Generate contract
deno run --allow-read --allow-write scripts/generate-from-template.ts \
  contract-template.docx replacements.json acme-contract.docx

Example 2: Report with Tables

Scenario : Generate a data report with tables and formatting.

spec.json :

{
  "title": "Sales Report",
  "sections": [{
    "content": [
      { "text": "Monthly Sales Report", "heading": 1 },
      { "text": "January 2025", "heading": 2 },
      {
        "runs": [
          { "text": "Total Sales: ", "bold": true },
          { "text": "$125,000", "color": "2E7D32" }
        ]
      }
    ]
  }]
}

Example 3: Letter with Headers/Footers

Scenario : Create a formal letter with letterhead.

spec.json :

{
  "sections": [{
    "header": {
      "paragraphs": [
        { "text": "ACME CORPORATION", "alignment": "center", "runs": [{"text": "ACME CORPORATION", "bold": true, "fontSize": 16}] },
        { "text": "123 Business Ave, City, ST 12345", "alignment": "center" }
      ]
    },
    "content": [
      { "text": "December 15, 2024", "alignment": "right" },
      { "text": "" },
      { "text": "Dear Valued Customer," },
      { "text": "" },
      { "text": "Thank you for your continued business..." },
      { "text": "" },
      { "text": "Sincerely," },
      { "text": "John Smith" },
      { "runs": [{ "text": "CEO", "italic": true }] }
    ],
    "footer": {
      "paragraphs": [
        { "text": "www.acme.com | contact@acme.com", "alignment": "center" }
      ]
    }
  }]
}

Script Reference

Script	Purpose	Permissions
`analyze-template.ts`	Extract text, tables, placeholders from DOCX	`--allow-read`
`generate-from-template.ts`	Replace placeholders in templates	`--allow-read --allow-write`
`generate-scratch.ts`	Create DOCX from JSON specification	`--allow-read --allow-write`

Specification Reference

Paragraph Options

Property	Type	Description
`text`	string	Simple text content
`runs`	array	Formatted text runs (for mixed formatting)
`heading`	1-6	Heading level
`alignment`	string	`left`, `center`, `right`,

Text Run Options

Property	Type	Description
`text`	string	Text content
`bold`	boolean	Bold formatting
`italic`	boolean	Italic formatting
`underline`	boolean	Underline formatting
`strike`	boolean	Strikethrough

Table Options

Property	Type	Description
`rows`	array	Array of row specifications
`width`	number	Table width as percentage
`borders`	boolean	Show table borders

Hyperlink Options

Property	Type	Description
`text`	string	Link text
`url`	string	Target URL
`bold`	boolean	Bold formatting
`italic`	boolean	Italic formatting

Common Issues and Solutions

Issue: Placeholders not being replaced

Symptoms : Output DOCX still contains {{PLACEHOLDER}} tags.

Solution :

Run analyze-template.ts to verify exact tag text
Tags may be split across XML runs - the script consolidates these automatically
Ensure includeHeaders and includeFooters are true if placeholders are there

Issue: Formatting lost after replacement

Symptoms : Replaced text doesn't match original formatting.

Solution :

Text replacement preserves the formatting of the original placeholder
Ensure placeholder is formatted the way you want the final text to appear

Issue: Images not appearing

Symptoms : Image elements are blank in output.

Solution :

Use paths relative to the spec.json file location
Verify image file exists and is readable
Check supported formats: PNG, JPEG, GIF

Issue: Table cell content incorrect

Symptoms : Table cells have wrong content or formatting.

Solution :

Each cell's content must be an array of paragraph specifications
Use shading for background color, verticalAlign for alignment

Limitations

DOCX only : Does not support legacy .doc format
No track changes : Cannot add or process track changes
No comments : Cannot add document comments
No macros : Cannot include VBA macros
Basic numbering : Limited support for complex numbering schemes
Text run splitting : Word may split text across XML elements; script handles common cases

Related Skills

pptx-generator : For creating PowerPoint presentations
xlsx-generator : For creating Excel spreadsheets
pdf-generator : For creating PDF documents

Weekly Installs

291

Repository

jwynia/agent-skills

GitHub Stars

First Seen

Jan 20, 2026

Security Audits

Gen Agent Trust HubPass SocketPass SnykWarn

Installed on

opencode263

codex253

gemini-cli250

cursor241

github-copilot241

amp222

agent-browser 浏览器自动化工具 - Vercel Labs 命令行网页操作与测试

140,500 周安装

DOCX 生成器 - 自动化 Word 文档生成与模板替换工具 | Deno 技能

🇨🇳中文介绍

DOCX 生成器

何时使用此技能

先决条件

快速开始

两种操作模式

相关 Skills

使用说明

模式 1：基于模板生成

步骤 1a：分析模板

步骤 1b：创建替换规范

步骤 1c：生成输出

模式 2：从头生成

步骤 2a：创建规范

步骤 2b：生成文档

示例

示例 1：合同生成

示例 2：包含表格的报告

示例 3：包含页眉/页脚的信函

脚本参考

规范参考

段落选项

文本片段选项

表格选项

超链接选项

常见问题与解决方案

问题：占位符未被替换

问题：替换后格式丢失

问题：图片未显示

问题：表格单元格内容不正确

限制

相关技能

🇺🇸English

DOCX Generator

When to Use This Skill

Prerequisites

Quick Start

Two Modes of Operation

Instructions

Mode 1: Template-Based Generation

Step 1a: Analyze the Template

Step 1b: Create Replacement Specification

Step 1c: Generate Output

Mode 2: From-Scratch Generation

Step 2a: Create Specification

Step 2b: Generate Document

Examples

Example 1: Contract Generation

Example 2: Report with Tables

Example 3: Letter with Headers/Footers

Script Reference

Specification Reference

Paragraph Options

Text Run Options

Table Options

Hyperlink Options

Common Issues and Solutions

Issue: Placeholders not being replaced

Issue: Formatting lost after replacement

Issue: Images not appearing

Issue: Table cell content incorrect

Limitations

Related Skills

最新 Skills