network-report-documents

用途：该技能负责四种文档“内容构成”，底层由 document-mcp 负责写入。适用于网络变更与审计报告场景：从 ServiceNow 变更单和真实设备状态生成变更记录 Word 文档、生成接口/配置审计工作簿、生成高管摘要演示文稿、填写必需的 PDF 表单。\n\n主要能力与用法：\n1. 变更记录（.docx）：数据来自 servicenow-change-workflow（只读，不创建或更新工单）与 fortigate-ops、multivendor-cli、pyats 的设备状态。含变更详情、变更前状态、拓扑图（仅当已有图技能产出）、回滚段落（仅叙述，不放数字）。CR 不存在或未批准时须停止并说明；ServiceNow 未配置时可只产出设备部分，但须声明 CR 部分为人工提供且未经验证。\n2. 接口/配置审计工作簿（.xlsx）：管理状态与运行状态须分列；失败设备写入 failed_rows 而非省略；设备描述按字面文本写入以防公式注入。服务端会以标记行渲染失败并报告 attempted/returned/failed。\n3. 高管摘要幻灯片（.pptx）：内容来自其他技能产出的发现和已生成的图文件；每张摘要页需有 detail_ref 指向详情页或 Sources 页；图须先由 drawio-diagram、markmap-viz、uml-diagram 或 threejs-network-viz 生成再传入路径，工作区输出目录之外的路径会被拒绝；来源须放在幻灯片可见框中而非备注。\n4. 填写 PDF 表单：先执行 pdf_inspect_form 获取真实字段名，再映射带标签的值；读取并报告未填与未匹配字段，无数据的字段保持真正空白。限制：填写后的表单不含 Sources 部分，来源记录保留在工具响应与 GAIT 记录中。\n\n核心限制：文档绝不编造、估算、插值或沿用旧值填补空白；设备无响应时发送 {"unavailable": "device did not answer"}。交付前须阅读结果，written_with_gaps 表示文档不完整并须说明；提供文件路径并说明哪些内容未经验证。创建、更新或关闭变更单属于 servicenow-change-workflow；发送文档属于 slack-report-delivery、webex-report-delivery，均不在此技能范围内。