report-to-google-slides

汇报至 Google Slides

仅当用户明确已有 HTML 分析报告，并希望将其制作成 Google Slides 交付物时，才使用此技能。输出应为幻灯片，而不是粘贴的报告。利益相关者只需浏览幻灯片，就应能了解结论、证据、注意事项和建议的后续行动，而无需打开源报告。

此技能处理 HTML 报告。它不会直接转换实时 MCP 应用报告；如果现有的只有 MCP 应用报告，应先基于相同的源证据生成 HTML 报告，作为单独的报告交付方式。

工作流

1. 确定本地 HTML 报告。

   使用绝对文件路径。如果用户提供的是远程报告，请先在此技能之外获取。如果本地文件是登录页、重定向页或非常小的占位文件，请停止操作，并先获取真正的报告。

2. 运行辅助程序。

   python3 <REPORT_TO_GOOGLE_SLIDES_SKILL_DIR>/scripts/report_to_google_slides.py \
     <LOCAL_HTML_REPORT_PATH> \
     --out-dir /tmp/report_to_google_slides
   

3. 检查本地输出。

   必需的输出：

   • deck.pptx：可编辑的本地 PowerPoint 文件
   • manifest.json：已解析的源内容清单和覆盖范围计数
   • deck_plan.json：包含命名元素的逐页计划
   • preflight_checks.json：本地质量检查及通过／失败状态
   • assets/：渲染后的图表图片

   在 preflight_checks.json 中的 status: "passed" 之前，不要导入 PPTX。 然后运行 unzip -t <out-dir>/deck.pptx。

4. 导入并在 Google Slides 中验证。

   使用 mcp__codex_apps__google_drive._import_presentation 导入 deck.pptx，并设置 upload_mode="native_google_slides"。尽可能使用 _get_presentation_outline 和 _get_slide_thumbnail 验证导入的演示文稿，检查每一张幻灯片。至少检查封面、一张图表页、一张表格页，以及注意事项／来源页。

5. 交付前修复问题。

   如果缩略图显示文字被裁切、图表缺失、对比度不足、图片空白或尺寸不协调，请修改辅助程序输出或源假设并重新生成，然后再交付演示文稿 URL。

6. 交付演示文稿。

   返回 Google Slides URL；如有帮助，也一并提供本地 PPTX 路径或源 HTML 路径。常规检查、预检、缩略图检查和导入检查的详情应保留在支持材料中。除非检查失败、无法进行或发现与用户相关的注意事项，否则不要在面向用户的交付说明中列出内部检查项。

标准

• 保留报告中对决策至关重要的信息：核心结论、执行摘要、主要发现、指标定义、重要图表、决策关键表格、建议、影响、注意事项、假设、时效性说明以及来源／出处说明。
• 将报告文字改写为适合幻灯片的表达。先给出结论，每张幻灯片只讲一个核心观点，并通过简洁的重点说明、项目符号、表格、图表注释或演讲者备注补充细节。
• 优先精简文字，不要先缩小字号。
• 如果源报告区分不同分析视角，应明确区分总指标读数、净值／增量读数、因果主张和注意事项。
• 尽可能使用可编辑文字和原生 PPTX 表格。使用原生 PPTX 项目符号；不要用手动输入的连字符伪造项目符号。
• 将源图表保留为证据图片。不要截取整个 HTML 报告的屏幕，也不要粘贴整段报告内容。
• 支持自包含的 Recharts HTML 报告，前提是其图表证据仍可通过相同数据的内嵌 SVG／表格回退内容或嵌入图片获取；辅助程序会在制作演示文稿前将这些内容渲染为本地图表证据图片。
• 每张证据幻灯片放置一个图表，除非报告更适合采用分组比较。
• 确保表格页清晰易读。如果完整表格过于密集，应在演示文稿中保留主要比较内容，并将额外细节移至演讲者备注或来源页。
• 来源说明应清晰可见，但不应喧宾夺主。

视觉系统

辅助程序会从 HTML 报告的 CSS 和图表配色中提取颜色与层级，并据此应用克制的分析型演示文稿布局。它不会套用外部演示文稿文件或特定公司的品牌设计。