报告审核模板生成器

解决什么问题

把一份散乱的巡检记录、运营月报数据或安全审核结果变成格式统一的正式报告，本身就是一件重复劳动：封面落款要手写、章节顺序要记住、风险表和整改表的列不能填错，抄送和密级还容易漏掉。当这类文档每周、每月都要出时，人工排版的一致性成本会迅速盖过写作本身。

这个技能做一件事：把原始数据交给它，拿回一份结构固定的标准报告。它不是帮你分析数据，而是帮你把已经分析好的内容装进一套被反复验证过的框架里。

核心能力

1. 固定的七章结构
默认输出七章，覆盖从结论到签发的完整链路：

• 总体研判结论（含指标总览表）
• 重大风险 P0 清单
• 核心技术 / 业务风险
• 报告与数据质量评估
• 各维度得分率与最弱项
• 优先级整改行动表（P0/P1/P2）
• 审阅结论与签发栏

其中风险清单表、整改行动表、签发栏是强制保留项，即使自定义章节也不会被删掉。

2. 可自定义品牌与落款
meta 参数支持主副标题、编制单位、审阅人、发布日期、密级标注、抄送列表、表头主色和落款单位文字。团队不必为每次下发重写抬头。

3. 四类输出格式

• docx：本地生成，字体和间距控制最精确，适合正式下发和存档
• pdf：由 reportlab 生成或从 docx 转换，适合对外发布
• 腾讯文档：通过 tencent-docs MCP 在线创建，适合多人协作
• 企业微信文档：通过 wecomcli-doc MCP 创建，适合企业内部流转

4. 结构化输入
sections 数组中每个元素带 type 字段，可选 h1、h2、p、table、list、pagebreak。表格直接用 headers 和 rows 传数据，不需要手工画线。

典型工作流

1. 整理输入：把检查记录或运营数据拆成 meta + sections
2. 选择格式：正式下发选 docx，在线审批选腾讯文档
3. 调用生成函数：Word 用 build_report()，PDF 用 build_report_pdf()
4. 交付：本地文件走签字下发，在线文档直接输出链接

适用边界

• 不接入实时数据，需要 IT 侧配合取数
• 不做数据分析或建模，只提供模板框架，指标结论需用户自行填写
• 不连接外部数据库
• 不处理图片与手写稿，OCR 内容需先人工转成文本
• 专业报告（安评、环评、能评、审计）应转交对应专业技能，本技能只覆盖通用报告模板

几个容易踩的坑

• sections 传空列表会生成只有封面的空白文档，至少传一个含内容的 section
• meta 不传 title 会拿到默认值「工作报告」
• PDF 中文显示方框是因为 reportlab 默认字体不含中文，需要先注册中文字体；更稳妥的做法是先出 docx 再转 PDF
• 不支持的 type 会被静默跳过，报告少一段内容时优先检查类型字段拼写
• 腾讯文档和企微文档需要对应 MCP 连接器已配置并授权

建议正式下发用 docx，在线协作用腾讯文档，两者排版能力有明显差距。