Docx Generator

jwynia/agent-skills/skills/general/document-processing/word/docx-generator

作者 jwyniae02ec7e226a6MIT168 个星标收录于 2026年10月8日更新于 2026年10月8日仓库7个月前更新

Create and manipulate Word DOCX files programmatically. Use when the user needs to generate documents, modify DOCX templates, extract document content, or automate Word document workflows. Supports both template-based generation (for branding compliance) and from-scratch creation. Keywords: Word, DOCX, document, report, template, contract, letter, corporate, branding.

包含脚本Documents & Office
AI 生成的概览

使用 Deno 脚本，通过模板或 JSON 规格创建和编辑 Word DOCX 文件。

功能
该技能以编程方式生成和操作 Word DOCX 文档。它可以分析现有 DOCX 模板，清点其中的文本、表格和占位符，然后用提供的值替换占位符标签，同时保留原有格式。它还可以依据 JSON 规格从零构建文档，涵盖标题、带格式的文本片段、表格、页眉、页脚、列表和超链接。技能附带三个 Deno 脚本，分别用于分析、基于模板生成和从零生成。
适用场景
当用户需要自动生成或修改 Word 文档（如报告、合同或信函）时使用。它适用于填充品牌模板、替换占位符，以及从现有 DOCX 文件中提取文本、表格和结构。不适用于查看文档、旧版 .doc 格式、复杂邮件合并或输出 PDF。
运行要求
需要安装 Deno，并具备 --allow-read 和 --allow-write 权限。模板模式需要输入 DOCX 文件和替换内容 JSON 文件；从零生成模式需要 JSON 规格文件。规格中引用的图片必须存在且为受支持格式（PNG、JPEG、GIF）。附带三个可执行的 TypeScript 脚本。

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

  1. Template Mode: Modify existing branded templates

    • Analyze template to find placeholders
    • Replace {{PLACEHOLDERS}} with actual content

  2. 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:

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

Output (inventory.json):

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:

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
bash
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:

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
bash
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:

bash
# 1. Analyze template for replaceable contentdeno run --allow-read scripts/analyze-template.ts contract-template.docx --pretty
# 2. Create replacements.json with client data# 3. Generate contractdeno 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:

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:

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 | [email protected]", "alignment": "center" }      ]    }  }]}

Script Reference

ScriptPurposePermissions
analyze-template.tsExtract text, tables, placeholders from DOCX--allow-read
generate-from-template.tsReplace placeholders in templates--allow-read --allow-write
generate-scratch.tsCreate DOCX from JSON specification--allow-read --allow-write

Specification Reference

Paragraph Options

PropertyTypeDescription
textstringSimple text content
runsarrayFormatted text runs (for mixed formatting)
heading1-6Heading level
alignmentstringleft, center, right, justify
bulletbooleanBulleted list item
numberingbooleanNumbered list item
spacingobjectbefore, after, line spacing
indentobjectleft, right, firstLine indentation
pageBreakBeforebooleanInsert page break before paragraph

Text Run Options

PropertyTypeDescription
textstringText content
boldbooleanBold formatting
italicbooleanItalic formatting
underlinebooleanUnderline formatting
strikebooleanStrikethrough
fontSizenumberFont size in points
fontstringFont family name
colorstringText color (hex, no #)
highlightstringHighlight color
superScriptbooleanSuperscript
subScriptbooleanSubscript

Table Options

PropertyTypeDescription
rowsarrayArray of row specifications
widthnumberTable width as percentage
bordersbooleanShow table borders

Hyperlink Options

PropertyTypeDescription
textstringLink text
urlstringTarget URL
boldbooleanBold formatting
italicbooleanItalic formatting

Common Issues and Solutions

Issue: Placeholders not being replaced

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

Solution:

  1. Run analyze-template.ts to verify exact tag text
  2. Tags may be split across XML runs - the script consolidates these automatically
  3. 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:

  1. Use paths relative to the spec.json file location
  2. Verify image file exists and is readable
  3. 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

来源与署名

来源：jwynia/agent-skills位于skills/general/document-processing/word/docx-generator提交e02ec7e

许可证： MIT

内容归原作者所有。SourceWeft 从公开仓库中收录这些内容。

举报或申请下架

更多来自 jwynia/agent-skills 的技能

Godot Best Practices

jwynia

指导 AI 代理按照命名、类型、场景与架构最佳实践编写 Godot 4.x GDScript 代码。

Software Development1687个月前更新

Shadcn Layouts

jwynia

通过应用 CSS 高度、flex、grid 与滚动心智模型，指导代理生成正确的 shadcn/Tailwind 布局。

Software Development1687个月前更新

System Design

jwynia

诊断软件系统设计问题，引导独立开发者完成架构决策、组件图与行走骨架。

Software Development1687个月前更新

Task Decomposition

jwynia

将庞大的开发任务拆分为更小、可估算、可独立交付的单元，并提供诊断状态与拆分模式。

Productivity & Workflow1687个月前更新

Requirements Analysis

jwynia

诊断软件项目中的需求问题，引导发现真实需求、约束与范围。

Software Development1687个月前更新

Code Review

jwynia

提供结构化的代码审查指导，涵盖缺陷、质量、安全与审查流程。

Software Development1687个月前更新

更多Documents & Office技能

Process Letter

anthropics

精选

起草卖方并购流程函、意向指示说明、最终投标程序及管理层会议邀请函。

Documents & Office39K2周前更新

Teaser

anthropics

精选

为卖方并购流程起草匿名的一页公司推介材料，在签署保密协议前不披露目标公司身份。

Documents & Office39K2周前更新

Clean Data Xls

anthropics

精选

清理杂乱表格数据：去除空白、统一大小写、转换文本数字、规范日期并删除重复项。

Documents & Office39K2周前更新

Datapack Builder

anthropics

精选

从CIM、申报文件、网络或MCP来源构建标准化的金融服务数据包，输出供投资评审使用的Excel工作簿。

Documents & Office39K2周前更新

Cim Builder

anthropics

精选

为卖方并购流程搭建并起草保密信息备忘录，产出 Word 文档及 Excel 财务附录。

Documents & Office39K2周前更新

Ppt Template Creator

anthropics

精选

将用户的 PowerPoint 模板转化为可复用技能，用于生成品牌演示文稿。

Documents & Office39K2周前更新