| name | docx-export |
| description | 把中文公文 Markdown 成稿导出为符合机关版式的 .docx。Use when the user wants to export/convert a 公文 Markdown draft to Word/.docx, adjust 字体、字号、页边距、行距、页码、标题断行, embed local images as 附件/附图, or inspect the resolved 字体与版式方案. 不负责起草内容，只负责渲染版式。 |
公文 docx 导出
把已成稿的中文公文 Markdown 渲染成符合机关版式的 .docx。这是「版式渲染」能力，不起草内容——起草走根目录「公文写作」skill，本 skill 只在 Markdown 结构正确后做导出与版式调整。
与「公文写作」共用同一份 prompts/ 主源（字体方案、版式方案、文种绑定），不复制规则。
文件索引
src/scripts/generate_docx.py # 导出器主入口（CLI）
src/scripts/install_fonts.sh # 安装 assets/fonts/ 下字体到系统
src/scripts/download_fonts.sh # 拉取开源替代字体
prompts/font-profiles/*.toml # 字体方案（标题/正文/层级字体字号）
prompts/layout-profiles/*.toml # 版式方案（固定行距、各段后距、首行缩进）
prompts/doc-types/<id>-<文种>/meta.toml # 文种 → font_profile / layout_profile 绑定
assets/fonts/catalog.toml # 字体族 → assets/fonts/ 具体文件映射
docs/references/font-usage.md # 字体速查、导出已知坑、自检命令（面向读者）
docs/references/layout-rules.md # 版式规范、已自动化/未自动化清单、页边距
调用方式
- 先确认 Markdown 结构正确（标题、主送单位、正文、落款、附注、附件等用
## 分块）。
- 按文种自动套字体与版式：
--doc-type <文种>（中文别名或英文 ID 均可），脚本据 meta.toml 解析 font_profile/layout_profile。
- 或手动指定：
--font-preset、--title-font、--body-font 等槽位。
- 导出前可用
--show-font-plan / --show-layout-plan 预览实际落到的字体、字号、版式参数。
python3 src/scripts/generate_docx.py 成稿.md -o 成稿.docx --doc-type 通知
python3 src/scripts/generate_docx.py --doc-type 报告 --show-font-plan
默认版式（主源）
- 页边距：按 GB/T 9704-2012，上 37mm、下 35mm、左 28mm、右 26mm（版心 156mm×225mm；常量真身在
src/docgen/constants.py 的 MARGIN_*_TWIPS，经 src/scripts/generate_docx.py 再导出）。
- 行距、各段后距、首行缩进：由文种绑定的
prompts/layout-profiles/*.toml 决定，不在文档里重复硬编码数值。
- 标题/正文/层级字体字号：由
prompts/font-profiles/*.toml + assets/fonts/catalog.toml 决定。
- 调整版式优先改对应
*.toml 主源；只在一次性需求时用 CLI 覆盖。
已知坑（症状 / 成因 / 对策）
- 换机器字体变样：脚本只写字体名、不嵌入
.ttf；目标机器先 bash src/scripts/install_fonts.sh，锁定视觉时导出 PDF。
- 图片没出现：仅支持本地
png/jpg/jpeg，用  独立成块，优先放 附件/附图/附录。
- 首页无页脚页码：预期行为（自第二页起显示）；完全不要页码加
--hide-page-number。
- 页脚灰底：是编辑器“域底纹”显示，非文档底纹。
更完整的字体速查与命令见 docs/references/font-usage.md，版式规范见 docs/references/layout-rules.md。
边界
- 不在自动化范围：机关红头套版、印章压成文日期、完整套红线——仍需用本单位 Word 模板做最后核定。
- 改字体/版式后若涉及
*.toml 主源，跑 python3 src/adapters/skill/build.py --check 确认产物同步。
