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 を使用し、upload_mode="native_google_slides" を指定して deck.pptx をインポートします。可能であれば、_get_presentation_outline とすべてのスライドの _get_slide_thumbnail を使って、インポート後のデッキを確認してください。最低限、表紙、チャートのスライド、表のスライド、注意事項／出典のスライドを確認します。

5. 引き渡す前に修正します。

   サムネイルにテキストの切れ、チャートの欠落、コントラスト不足、空白の画像、または不自然なサイズが見られる場合は、デッキの URL を引き渡す前に、ヘルパーの出力またはソースに関する前提を修正して再生成してください。

6. デッキを引き渡します。

   Google Slides の URL を返します。必要に応じて、ローカル PPTX のパスまたはソース HTML のパスも添えてください。定例のチェック、事前検査、サムネイル確認、インポート確認の詳細は、補助資料に記録してください。チェックに失敗した場合、実施できなかった場合、またはユーザーに関係する注意事項が判明した場合を除き、ユーザー向けの引き渡しには内部チェックを記載しないでください。

基準

• レポートの意思決定に不可欠な情報を保持してください。主張の要点、エグゼクティブサマリー、主要な調査結果、指標の定義、重要なチャート、意思決定に不可欠な表、推奨事項、示唆、注意事項、前提、情報の鮮度に関する注記、出典／来歴に関する注記が含まれます。
• レポートの文章をスライドに適した伝え方に変えてください。結論を先に示し、各スライドでは主題を一つに絞り、補足情報は簡潔なコールアウト、箇条書き、表、チャート注釈、または発表者ノートにまとめてください。
• フォントを小さくする前に、文章を簡潔にしてください。
• ソースレポートで区別されている場合は、総指標値、純増／増分値、因果関係に関する主張、注意事項を明確に分けてください。
• 可能な限り編集可能なテキストと PPTX ネイティブの表を使用してください。PPTX ネイティブの箇条書きを使い、入力したダッシュで箇条書きを装わないでください。
• 根拠画像としてソースのチャートを保持してください。HTML レポート全体をスクリーンショットにしたり、レポートのセクション全体を貼り付けたりしないでください。
• セルフ完結型の Recharts HTML レポートにも対応します。チャートの根拠が、同じデータを用いたインライン SVG／表の代替表示、または埋め込み画像として残っている場合、ヘルパーがデッキを作成する前にそれらをローカルのチャート根拠画像としてレンダリングします。
• レポートに、より適切な比較グループがない限り、根拠を示すスライドにはチャートを一つだけ配置してください。
• 表のスライドは読みやすくしてください。表全体が詰め込みすぎになる場合は、主要な比較をデッキに残し、追加の詳細を発表者ノートまたは出典スライドに移してください。
• 出典に関する注記は、目に留まるようにしつつ、控えめに表示してください。

ビジュアルシステム

ヘルパーは HTML レポートの CSS とチャートの配色から色と階層を導き、落ち着いた分析用デッキのレイアウトを適用します。外部のデッキファイルや企業固有のブランディングには従いません。