⚡

参考Word格式技能Skill reference-word-format

该技能可以根据用户提供的参考Word文档自动提取并继承其页面、节、页眉页脚、样式、编号、表格、目录/域、段落与字符格式，用新的内容生成同格式Word。适用于“按照这个Word的格式帮我写/生成/整理一份……”等请求。参考Word是强制前置条件，没有参考Word时不得开始生成，应要求用户先提供。格式默认严格继承；是否强制保留参考文档的章节/目录结构由用户意图决定，必要时询问一次。关键词：参考Word, 格式提取, 模板复制, 文档生成, 样式继承, 自动化。

AI应用 0 次安装 18 次浏览 更新于 8/12/2026

name: reference-word-format version: 2.1.0 description: 根据用户在当前任务中提供的参考 Word（.doc/.docx/.dotx）自动提取并继承其页面、节、页眉页脚、样式、编号、表格、目录/域、段落与字符格式，用新的内容生成同格式 Word。适用于“按照这个 Word 的格式帮我写/生成/整理一份……”等请求。参考 Word 是强制前置条件；没有参考 Word 时不得开始生成，应要求用户先提供。格式默认严格继承；是否强制保留参考文档的章节/目录结构由用户意图决定，必要时询问一次。

参考 Word 格式技能

1. 目标

把用户提供的 Word 文档当作运行时格式参考模板，先分析其真实 DOCX/OOXML 结构，再用新的业务内容生成新的 Word 文档。

本 Skill 不绑定任何行业、章节、模板名称或固定文档内容。

核心原则：

参考 Word 决定格式；用户需求决定内容；章节结构是否继承是独立选择。

典型触发请求：

  • “按照这个 Word 的格式帮我写一份 XXX。”
  • “参考附件的格式生成新的报告。”
  • “照这个文档版式，把下面这些内容做成 Word。”
  • “保留这个模板的格式，但内容换成 XXX。”
  • “按参考文档的样式生成一份新的文档。”

2. 强制前置条件：必须有参考 Word

2.1 必须执行的输入门禁

开始任何格式提取、模板复刻或新 Word 生成前，必须确认当前任务中存在至少一个可访问的参考 Word 文件：

  • .doc（Word 97-2003 二进制格式），或
  • .docx，或
  • .dotx。

2.2 没有参考 Word 时

不得：

  • 从空白 Word 猜测模板；
  • 根据截图或文字描述宣称“严格复刻”；
  • 使用 Skill 自带的某个默认模板替代；
  • 先生成一个“差不多”的 Word 再让用户补模板。

应直接要求用户上传参考 Word，例如：

请先提供一个作为格式参考的 Word 文件（.doc、.docx 或 .dotx）。这个任务需要从参考文档中提取真实样式、页面、页眉页脚、编号和表格等格式信息，没有参考 Word 无法严格按格式生成。

如果用户只提供 PDF/图片，可说明它可以用于视觉参考，但不满足“严格提取 Word 格式”这一 Skill 的前置条件；仍需 Word 文件。

2.3 多个 Word 文件

如果用户上传多个 Word 且没有明确哪个是格式参考：

  • 优先从语义上判断哪个被称为“模板 / 参考 / 样例 / 按这个格式”；
  • 若仍无法确定，只询问“哪一个作为格式参考 Word？”；
  • 不要自行把多个模板混合成一个样式体系。

2.4 .doc 兼容处理（强制规则）

.doc 是 Word 97-2003 的二进制格式，不是 OOXML，不能像 .docx 一样直接读取 styles.xml、numbering.xml 等部件。Skill 必须把它作为正式支持的参考输入，但内部先标准化：

  1. 保留原始 .doc，不得覆盖；
  2. 使用 LibreOffice/Word 兼容转换生成临时 .docx；
  3. 后续格式提取、内容写入、OOXML 校验都基于该标准化 .docx；
  4. template_profile.json 必须记录源格式为 .doc、转换工具/版本以及转换后文件；
  5. 严格模式下必须比较转换前 .doc 与转换后 .docx 的渲染效果。

如果转换前后出现明显的分页、字体、表格、图片、页眉页脚、域或对象差异：

  • 不得宣称已经“严格复刻”；
  • 优先调整转换或生成方式；
  • 若仍无法消除，应明确告诉用户 legacy .doc 转换造成了格式损失，并建议提供原始 .docx 版本。

因此，.doc 的支持定义为：

可作为必需的参考 Word 输入；通过受控转换进入 OOXML 工作流，并以视觉一致性校验约束转换损失。

3. 第二个决策：章节结构是否强制保留

“格式继承”与“章节结构继承”必须分开处理。

参考 Word 中的章节标题和目录结构属于内容结构，不等于视觉格式本身。

3.1 默认判断规则

如果用户明确说：

  • “章节也保持一致”
  • “按这个模板填写”
  • “不要改目录结构”
  • “在原章节下填内容”

则：

preserve_structure = true

如果用户明确说：

  • “只参考格式”
  • “内容结构按我的材料来”
  • “章节可以重新组织”
  • “只要版式一样”

则：

preserve_structure = false

3.2 用户没有说明时

如果章节选择会显著影响最终文档，应询问一次：

是否需要强制保留参考 Word 的章节/目录结构？如果不保留，我会继承它的版式和样式，但按新内容重新组织章节。

如果用户请求已经足够明确，不要重复询问。

3.3 两种模式

模式 A：严格格式 + 保留章节结构

适合固定模板、制度文件、质量体系文件、申请表、标准报告、规范性文档等。

要求：

  • 保留参考文档章节层级与顺序；
  • 优先在现有章节槽位中替换/填充正文；
  • 原有固定章节不可随意删除或改名，除非用户要求；
  • 目录由真实 Heading/TOC 机制维护，不手工伪造。

模式 B：严格格式 + 新章节结构

适合“只借用版式”的报告、方案、总结、说明书等。

要求：

  • 页面、页眉页脚、字体体系、标题层级样式、正文样式、编号风格、表格视觉语言等继续继承参考 Word；
  • 章节名称、数量和顺序按新内容组织；
  • 新标题必须使用从参考文档识别出的对应标题样式或复制后的等价样式；
  • 不把参考文档的旧章节标题当成必须保留的内容。

4. 核心方法：先提取，再生成

不得仅凭“看起来像”去复刻。

应至少分析以下层级：

4.1 文档级

提取：

  • 页面宽高；
  • 纵向/横向；
  • 页边距；
  • 装订线；
  • 默认字体/语言；
  • 主题字体与颜色；
  • 文档默认段落/字符属性；
  • 是否开启域更新；
  • 兼容性/分页相关设置。

4.2 Section 级

逐节提取：

  • section break 类型；
  • 页面尺寸与方向；
  • 页边距；
  • 页眉/页脚距离；
  • 首页不同；
  • 奇偶页不同；
  • 页眉页脚是否链接前一节；
  • 分栏设置；
  • 页码起始/编号方式。

4.3 页眉页脚

提取：

  • 文本；
  • 表格；
  • 图片/Logo；
  • PAGE / NUMPAGES 等域；
  • Tab stop；
  • 对齐；
  • 边框/底纹；
  • 与 section 的关系。

除非用户要求改变，生成时优先直接继承这些对象，而不是重建。

4.4 样式系统

从 styles.xml 和 Word 对象模型识别：

  • paragraph style；
  • character style；
  • table style；
  • numbering style；
  • basedOn 继承关系；
  • next style；
  • linked style；
  • docDefaults；
  • theme font；
  • 中文/西文字体；
  • 字号、粗体、斜体、颜色；
  • 行距、段前段后；
  • 缩进；
  • keepNext / keepLines / pageBreakBefore；
  • widow control；
  • tab stops。

不要只读取 run.font；必须考虑**有效样式（effective formatting）**来自样式继承、主题和直接格式的叠加。

4.5 标题与编号

提取：

  • 哪些样式承担 Heading 1/2/3… 语义；
  • outline level；
  • numId / abstractNumId；
  • 各 level 的编号格式；
  • %1.%2 等编号模式；
  • 起始编号；
  • 缩进、悬挂、制表位；
  • 标题与 TOC 的关联。

生成时不得手写 1、1.1、1.1.1 来伪造自动编号，除非参考文档本来就是纯文本编号且无法恢复编号定义。

4.6 表格

提取：

  • 行列结构；
  • 合并单元格；
  • 固定/自动列宽；
  • 行高；
  • 表格对齐；
  • 单元格边距；
  • 边框；
  • 底纹；
  • 表头重复；
  • 单元格垂直对齐；
  • 单元格内段落样式；
  • 跨页规则。

如果新内容需要同类表格，优先复制参考表格或表格结构后填值，而不是根据肉眼重新绘制。

4.7 域与自动内容

识别并尽量保留：

  • TOC；
  • PAGE；
  • NUMPAGES；
  • REF；
  • SEQ；
  • PAGEREF；
  • 图表/题注编号；
  • 书签；
  • 超链接。

生成后设置 w:updateFields=true；必要时更新或物化域用于 QA。

4.8 直接格式与特殊对象

记录：

  • 段落/Run 的 direct formatting；
  • 文本框；
  • Shapes；
  • 图片；
  • 水印；
  • 内容控件（SDT）；
  • 分页符；
  • 分节符；
  • 脚注/尾注；
  • 题注。

如果这些对象影响版式，应保留或复制，而不是丢弃。

5. 格式提取产物

对每个参考 Word，应在工作目录生成一个运行时 template_profile.json，至少包含：

{
  "reference_file": "reference.docx",
  "format_mode": "strict",
  "preserve_structure": false,
  "sections": [],
  "styles": {},
  "semantic_style_map": {
    "document_title": null,
    "subtitle": null,
    "heading_1": null,
    "heading_2": null,
    "heading_3": null,
    "body": null,
    "caption": null,
    "quote": null,
    "list": null
  },
  "numbering": {},
  "headers_footers": {},
  "tables": [],
  "fields": [],
  "chapter_outline": [],
  "ooxml_hashes": {}
}

semantic_style_map 必须根据当前参考 Word 动态推断，不允许写死 Heading 1、正文、Normal 等名称。

如果某类语义样式在参考 Word 中不存在，应记录为 null，后续不得假装已经提取到。

6. 内容建模：AI 只描述语义，不描述视觉

AI 新内容推荐先形成结构化内容模型，例如：

{
  "title": "新的文档标题",
  "blocks": [
    {"type": "heading", "level": 1, "text": "项目概述"},
    {"type": "paragraph", "text": "……"},
    {"type": "heading", "level": 2, "text": "建设目标"},
    {"type": "paragraph", "text": "……"},
    {
      "type": "table",
      "columns": ["项目", "说明"],
      "rows": [["A", "……"]]
    }
  ]
}

内容模型中原则上不要让 AI 自由指定：

  • font family；
  • font size；
  • line height；
  • margin；
  • RGB color；
  • table border；
  • paragraph spacing。

这些属性应从参考 Word 的 template_profile / 原始样式中继承。

7. 生成策略

7.1 黄金规则：复制参考 Word，再编辑

严格格式模式下：

  1. 复制用户提供的参考 Word 为工作文件；
  2. 在副本上替换或清理原有业务内容；
  3. 保留并复用其 styles、numbering、theme、section、header/footer 和关系；
  4. 插入新内容时绑定已有样式；
  5. 新增复杂对象时优先复制参考文档中的同类对象。

不要从 Document() 空白文档开始重建。

7.2 当 preserve_structure=true

  • 提取现有章节 outline；
  • 把新内容映射到现有章节；
  • 对空缺内容按用户资料处理，不擅自补知识；
  • 用户没要求删除的固定章节保留；
  • 原章节标题的样式、编号和顺序保持。

7.3 当 preserve_structure=false

  • 可移除参考文档旧业务正文；
  • 保留其格式资产；
  • 依据用户新内容创建新的章节树；
  • level 1/2/3… 映射到参考文档识别出的语义标题样式；
  • 正文映射到参考正文样式；
  • 新列表映射到最接近的参考列表样式；
  • 新表格优先匹配参考文档同类表格设计。

7.4 参考文档没有对应组件时

例如用户要求插入三级标题，但参考文档只存在两级标题：

  • 不要擅自声称“严格继承了三级标题格式”；
  • 优先从已有层级规律推断并复制最接近的 OOXML 属性；
  • 如果推断会显著影响模板一致性，应向用户说明该组件在参考文档中不存在；
  • 生成后必须重点做视觉 QA。

8. 禁止事项

除非用户明确要求修改参考模板的格式，否则禁止：

  1. 使用固定内置行业模板替代用户参考 Word；
  2. 把某个历史附件的章节写进 Skill 规则；
  3. 从空白 DOCX 重新设计页面；
  4. 仅凭截图猜字体、字号、边距；
  5. 把标题编号写成普通文本来冒充自动编号；
  6. 用空格反复填充来模拟 Tab / 对齐；
  7. 把页眉页脚复制为正文段落；
  8. 无理由重建已有表格；
  9. 把参考文档的业务内容误认为通用模板规则；
  10. 为了填满章节而编造用户没有提供的事实；
  11. 跳过最终 DOCX 渲染检查。

9. 推荐执行流程

Step 0 — 输入门禁

确认：

  • 有参考 Word；
  • 有用户的新文档目标或内容来源。

没有参考 Word：停止并要求上传。

Step 1 — 判断章节模式

确定：

  • preserve_structure=true，或
  • preserve_structure=false。

用户未说明且选择很重要：询问一次。

Step 2 — 标准化并分析参考 Word

如果参考文件是 .doc，先生成可编辑的 OOXML 工作母版：

python scripts/normalize_reference_word.py \
  /path/to/reference.doc \
  --output /mnt/data/reference.normalized.docx \
  --report /mnt/data/reference_normalization.json

.docx / .dotx 不需要格式转换。随后运行：

python scripts/analyze_reference_docx.py \
  /path/to/reference.doc \
  --output /mnt/data/template_profile.json

analyze_reference_docx.py 本身也接受 .doc，会自动标准化后再提取。结合 OOXML 与 python-docx 检查 profile，不仅依赖解析文本。

Step 3 — 渲染参考 Word 做视觉基线

对任意 .doc/.docx/.dotx 参考文件，可直接运行通用参考渲染器：

python scripts/render_reference_word.py \
  /path/to/reference.doc \
  --output-dir /mnt/data/reference_render

对于 .docx/.dotx，最终文档 QA 仍优先使用系统 canonical render_docx.py。

逐页查看参考 Word，理解真实版式。若源文件是 .doc，还必须分别渲染原始 .doc 与标准化 .docx：

python scripts/render_reference_word.py /path/to/reference.doc --output-dir /mnt/data/source_doc_render
python scripts/render_reference_word.py /mnt/data/reference.normalized.docx --output-dir /mnt/data/normalized_docx_render

对页面数量、分页、页眉页脚、字体、表格、图片和特殊对象进行转换前后对照；明显不一致时不得继续宣称 strict。

Step 4 — 生成内容计划

根据用户资料生成结构化内容；不要把参考文档中的示例正文自动带入新文档，除非用户要求保留。

Step 5 — 复制参考 Word 为工作副本

python scripts/clone_reference.py \
  /path/to/reference.doc \
  /mnt/data/output.docx

对于 .docx/.dotx，这是副本；对于 .doc，clone_reference.py 会先受控转换为 .docx 工作母版。后续只操作工作母版，不修改原始参考文件。

Step 6 — 在副本中写入新内容

优先使用：

  • python-docx 做常规段落、表格、图片操作；
  • OOXML 做编号、域、复杂表格、特殊对象等需要精准控制的部分。

每个新增块都必须能说明它继承/复制了参考文档中的哪个格式来源。

Step 7 — 结构/格式校验

python scripts/validate_against_reference.py \
  --reference /path/to/reference.doc \
  --candidate /mnt/data/output.docx \
  --profile /mnt/data/template_profile.json

如果要求保留章节，再加：

  --preserve-structure

Step 8 — 强制视觉 QA

使用 canonical renderer：

python /home/oai/skills/docx/render_docx.py \
  /mnt/data/output.docx \
  --output_dir /mnt/data/output_render \
  --emit_pdf

必须逐页检查：

  • 字体和字号层级是否一致；
  • 页眉页脚是否漂移；
  • 页边距是否变化；
  • 标题编号是否异常；
  • 表格是否破框或错位；
  • 图片是否越界；
  • 目录是否异常；
  • 是否出现裁切、重叠、孤行、空白页；
  • 中文字体是否缺字；
  • 新内容变长后分页是否合理。

发现问题后修改并重新 render → inspect → validate。

Step 9 — 交付

默认只交付最终 .docx。

除非用户要求，不交付：

  • QA PNG；
  • 中间 PDF；
  • 临时 JSON；
  • 解析缓存。

10. 严格程度

默认 strict。

strict

目标：尽可能使新文档看起来像“同一个 Word 模板生成的另一份文件”。

优先保持：

  • 页面/section；
  • 页眉页脚；
  • style definitions；
  • numbering definitions；
  • theme；
  • 标题体系；
  • 正文体系；
  • 表格视觉语言；
  • 自动域机制。

允许变化：

  • 新内容导致的合理分页；
  • 用户明确要求的新章节；
  • 数据量导致的表格增行；
  • 用户要求替换的封面字段/业务字段。

11. 用户沟通规范

缺少参考 Word

只解决这个前置条件，不先讨论详细格式参数：

请先上传一个参考 Word（.doc / .docx / .dotx）。我需要直接读取它的样式、页面、编号、页眉页脚和表格结构，才能严格按它的格式生成新的文档。

已有参考 Word，但章节模式不明确

可问：

这次需要连参考文档的章节/目录结构也强制保留吗？如果不保留，我会只继承它的格式体系，并按你的新内容重新组织章节。

已经明确

不要重复确认，直接执行。

12. 验收标准

最终 Word 至少满足：

  • 用户提供的 Word 是本次格式来源；
  • 未偷偷切换为 Skill 内置模板；
  • 已生成并检查 template_profile.json；
  • 页面与 section 关键参数符合参考文档；
  • 页眉页脚继承正确；
  • 新标题使用参考文档标题体系；
  • 新正文使用参考正文体系；
  • 编号不是肉眼伪造；
  • 表格尽量继承参考设计；
  • 是否保留章节结构符合用户选择；
  • 最终 DOCX 已 render 并逐页检查；
  • 没有明显排版错误后才交付。