按指定模板生成 Word
将用户内容写入已有 .docx 模板,保留原生页面、段落、表格、编号和字体设置。输入为模板文件及待填内容,输出为新的 Word 文档和处理报告。原模板和源内容保持不变,报告和复核文件写入任务工作目录。
选择流程
- 填充占位符或替换指定段落:读取 字段填充流程,先检查模板,再按 填充计划格式 编写带锚点校验的计划。
- 用 Markdown 替换旧正文:读取 正文迁移规则。涉及封面或前置内容时,为当前模板编写 profile,使用模板原文作为精确锚点。
- 更新目录、页码或检查字体效果:读取 排版与交付。WPS 及 RPC 运行时为可选外部依赖。
缺少模板或待填内容时,先向用户索取缺失输入。没有可靠目标位置的内容应报告为未映射,不猜测替换位置。
执行约束
- 复制模板包后编辑,不从零重建布局;输出路径必须与输入不同。
- 使用明确占位符或已核对的段落锚点,保留段落、run、编号、节和域结构。结构调整需要模板专用规则和验证。
- 检查替换报告并复查输出。Markdown 迁移必须通过集成逻辑校验才能交付。
- XML 校验不能证明视觉排版一致,也不会重算页码。只有排版引擎成功完成后才能声称目录和分页已更新;用户要求 PDF 或已授权的视觉复核需要 PDF 时才导出。
- 不支持将闭环框图自动渲染为图片;遇到此类输入会拒绝生成,应先为本任务单独准备图示或调整源内容。
命令
先定位本 skill 的安装目录,再从该目录运行以下命令;也可用脚本的绝对路径调用。输入、输出和报告使用任务工作目录的绝对路径,避免依赖用户当前目录或把产物写入安装目录。
python3 scripts/inspect_docx.py TEMPLATE.docx --summary --output INVENTORY.json
python3 scripts/fill_docx.py TEMPLATE.docx PLAN.json OUTPUT.docx --report REPORT.json
python3 scripts/render_markdown_into_docx.py TEMPLATE.docx SOURCE.md OUTPUT.docx --report REPORT.json
python3 scripts/verify_rendered_docx.py OUTPUT.docx SOURCE.md --json
仅在需要更新域且 WPS 环境可用时运行:
python3 scripts/wps_finalize.py OUTPUT.docx --report WPS-REPORT.json
标准库流程无需安装第三方包或配置 API Key。可复用实现位于 scripts/word_template_fill/,顶层脚本提供命令入口。
交付
提供输出 DOCX 和处理报告的路径,简述已填内容、未映射项以及校验结果。明确是否执行过排版引擎更新;未执行时说明页码和视觉排版仍需在 Word/WPS 中复核。