DOCX 文档创建与编辑

何时使用

• 最终交付物为文档且用户未指定格式时，默认生成 .docx
• 用户明确要求生成、导出、下载 Word 文档
• 对现有 .docx 做文本替换（正文、页眉、页脚）
• 解包查看 Word XML 结构并重新打包

注意：任务过程中的中间生成物（如临时数据文件、处理脚本等）不需要使用本技能，格式自由选择。

何时不要使用

• 批注、回复批注
• 接受修订或保留修订
• 大规模样式重构、复杂目录修复、复杂域代码处理

快速参考

工作流 A：创建新文档

流程分三步：根据内容基调设计视觉风格 → 用 start_write_file / end_write_file 编写语义化 HTML → 通过 jupyter_cell_exec工具 执行转换脚本输出 .docx。

第 1 步：分析内容基调，推演视觉风格

在编写 HTML 前，先完成意图识别与风格推演，并将结果直接落实到后续 CSS 中：

• 色板：根据内容基调设定主标题颜色、正文颜色和弱化文本颜色。轻量级高亮可使用浅色背景。公文、法律声明、严肃通知、学术论文等严肃场景禁止使用彩色，仅使用 #000000 和 #333333
• 字体：正式报告优先使用衬线体（宋体、仿宋）；现代文档或技术文档优先使用无衬线体（微软雅黑、黑体）；代码部分使用等宽字体（Consolas）；公文场景禁止使用非衬线字体，默认全用宋体或黑体
• 节奏：设定符合打印和离线阅读的行高（如 1.5 到 1.8）、统一段落间距（如 12pt）及章节留白

第 2 步：用 start_write_file / end_write_file 编写 HTML 文件

> 强制规则：必须使用 start_write_file + end_write_file 写入 HTML 文件。禁止通过 Python 代码生成 HTML 内容。 HTML 内容应由你直接以文本形式输出，以充分发挥 LLM 的长文本生成能力和排版能力。

1. 调用 start_write_file(path="/<文档名>.html") 开启写作模式
2. 直接以 开头输出完整 HTML（禁止使用 `html 等 markdown 代码围栏包裹，直接输出原始 HTML 内容）
3. 输出完毕后调用 end_write_file() 保存文件

生成 HTML 时，提示词正文按以下约束执行：

• 适用范围：本规范仅适用于经 html2docx() 转为 Word 文档的 HTML 源文件，不适用于其他场景的 HTML 写作
• 角色目标：根据用户输入指令，生成专门用于转换为 .docx 文件的单文件 HTML 源文件，要求结构严谨、内容生动、具备专业美感，并适配 Word 离线阅读场景
• 核心目标：深入理解用户输入内容的意图、受众和情感基调，量身定制符合 Word 渲染逻辑的视觉呈现方案；排版兼顾信息层级秩序与文档正式感，确保转换为 .docx 后仍具备良好阅读体验

_Technical Constraints（Word 渲染限制，必须绝对遵守）：_

• 禁用现代布局：绝对不可使用 Flexbox（display: flex）、CSS Grid（display: grid）、float、position: absolute、position: fixed；若需左右分栏或复杂对齐，必须且只能使用无边框表格：
  禁用现代 CSS 特性：绝对不可使用 CSS 变量（var(--xxx)）、calc()、clamp()、伪类（如 :hover）、transition、媒体查询（@media）
  安全单位与颜色：字体大小和行高必须使用 pt 或 px，缩进和间距可使用 em；颜色值必须使用确定的 Hex 值，如 #000000，不可使用 rgba() 或 hsla()
  字体声明机制：必须使用标准 CSS 的字体回退机制，并严格遵守“先英文字体，后中文字体”的声明顺序，例如 font-family: Arial, "Microsoft YaHei", SimSun, sans-serif;

  _语义化重组与内容强化：_

  • HTML 必须包含完整 结构，且头部必须声明
  • 严格按信息层级分配 h1 到 h6，为 Word 自动目录做好结构化准备
  • 在不改变核心原意的前提下优化可读性：长段落中的关键结论可独立抽取并使用

    包裹，配合左侧粗边框（border-left）和极浅背景色强调；公文等严肃文档不宜使用此样式

  • 将松散短句归纳为
    或
    列表，并保持列表项间距适中
    • 识别专业术语、代码片段、按键，使用 标签包裹，并设置浅灰背景、圆角及等宽字体

    _Word 兼容 CSS 构建：_

    • CSS 仅允许写在 的