用途:创建、读取、编辑和检查 Word 文档(.docx),包括报告、信函和格式化表格;当 DOCX 文件作为输入或被要求输出时使用。
主要能力:使用 python-docx 创建文档和进行常规编辑;检查段落、run、表格、节、页眉和页脚;使用段落样式设置标题与正文;处理表格尺寸、合并单元格和嵌套表格;通过共享检查脚本校验 ZIP/XML 完整性与内部关系,并统计段落、逻辑表格尺寸和节;可选 --contains TEXT 断言必需文本;可渲染为图片或转换为 PDF。
使用方式:默认调用 load_workspace_dependencies,并用返回的 Python 路径及其捆绑库执行,不安装包、不查找系统 Python。新建文档示例:from docx import Document; document = Document(); document.add_heading("Project report", level=0); document.add_paragraph("Summary", style="Heading 1"); document.add_paragraph("The requested findings go here."); document.save("report.docx")。检查命令:<python> <skill-directory>/../scripts/check_office.py <document.docx> --out <checks.json>。渲染示例:"<node>" "<cli>" render --input report.docx --output-dir preview-v1 --pages 1,3 --dpi 144;转换示例:"<node>" "<cli>" convert --input report.docx --output report.pdf。交付时调用 present({"files":[{"path":"report.docx"}]})。
限制:python-docx 不进行分页或渲染;普通替换、彩色文本或批注不应表示为修订;替换段落 .text 会破坏 run 格式;重建整个文档可能丢失 python-docx 编辑 API 之外的功能;中日韩文本可能需要显式设置 w:eastAsia 字体;结构检查不验证分页、裁剪、字体或视觉外观;LibreOffice 分页可能与 Microsoft Word 不同;渲染器不可用或失败时应报告检查限制,不另寻替代方案。源脚本、中间文件和最终文档应保存在任务工作区,运行时和技能目录为只读资源。