技能介绍

要解决什么问题

很多正式文档不是「写一篇文章」，而是在固定 Word 模板里填坑：项目申报书、教案、课程标准、定期报表往往整篇由多层表格构成，占位符藏在单元格里（「请填写 XXX」「本部分需依据 XXX」），样式和合并单元格还不能被破坏。人工对照多份参考资料复制粘贴，容易漏项、改错静态表头，或在嵌套表格里填错位置。

技能如何工作

docx-fill 采用「模板锚定填充（Template-Anchored Fill）」：先用代码从 .docx 提取段落、表格、合并单元格与样式，得到 raw_structure.json，避免 LLM 误读结构；再由 STRUCTURE_AGENT 只依据模板原文识别占位符，产出结构化的 Fill Contract（约束显式化，不混入推理）。

后续流程按契约分工：

CONFLICT_CHECKER：对照参考资料暴露矛盾，有冲突时等待用户选择后再继续
CONTENT_AGENT：按契约逐占位符生成 generated_content.json
EVALUATOR：独立做语义与幻觉检查（与撰写角色隔离）
代码步骤做 Tier 1+2 校验，最后用 python-docx 按 location 回填，is_static=true 的文本原样保留

表格密集型场景有专门约定：嵌套表用 nested_table_index 定位，合并单元格按逻辑单元格处理，跨格内容用 span 标记起始单元格。

适用边界与注意点

触发需同时提供：模板路径（template_path）与参考资料（reference_materials）；可选 output_path，默认在模板同目录生成 filled_.docx。约束仅来自模板原文，技能不会自行添加模板未写明的规则；参考资料互相矛盾时必须人工决策，不会静默选一边。