/pptx-converter

name: pptx-converter
description: "PPTXテンプレート変換 & ゼロからデッキ生成。テーマ・アニメーション・SmartArtを保持してコンテンツを書き換え。 「PPTX変換」「スライド作成」「パワポ書き換え」「デッキ生成」等のリクエストで発動。"
triggers:
  - PPTX変換
  - スライド作成
  - パワポ書き換え
  - デッキ生成
  - pptx-converter
  - PowerPoint変換
  - テンプレートを使ってスライド作成
version: 1.0.0
author: CursorBootcamp
dependencies:
  - python: 3.8+
  - packages: ["python-pptx", "pyyaml", "lxml", "google-generativeai", "python-dotenv", "Pillow"]

トリガーワード

「PPTX変換」「スライド作成」「パワポ書き換え」「デッキ生成」「PowerPoint」

PPTX Converter

PowerPointファイルのテンプレート変換とゼロからのデッキ生成ツール。

機能

1. convert - テンプレート変換（1コマンド完結）

元PPTXをコピーして、全要素をGeminiで意味解析し、新トピックに合わせてコンテンツを自動書き換え。

python skills/pptx-converter/scripts/pptx_converter.py convert \
    source.pptx \
    --topic "2026年Q1営業報告" \
    -o output/slides/q1_report.pptx

**保持されるもの:** スライドマスター、テーマカラー、フォント定義、アニメーション、トランジション、SmartArt構造、レイアウト配置

2. extract - マッピングYAML生成

元PPTXの全要素を抽出・意味解析し、座標-要素マッピングYAMLを生成。手動確認・編集用。

python skills/pptx-converter/scripts/pptx_converter.py extract \
    source.pptx \
    -o mapping.yaml

3. build - マッピング + データ → PPTX

手動編集したデータYAMLで要素を書き換え。

python skills/pptx-converter/scripts/pptx_converter.py build \
    source.pptx \
    mapping.yaml \
    --data data.yaml \
    -o output.pptx

4. deck - ゼロからデッキ生成

トピックからGeminiでアウトライン生成 → PPTX自動作成。

python skills/pptx-converter/scripts/pptx_converter.py deck \
    --topic "AIエージェント活用提案" \
    --type proposal \
    --style corporate \
    -o output/slides/proposal.pptx

**deck オプション:**

• `--type`: auto / presentation / proposal / report / educational / pitch
• `--style`: corporate / creative / minimal / academic
• `--slides N`: スライド枚数（0=AI決定）
• `--audience`: 対象者
• `--outline-only`: アウトラインYAMLのみ出力

対応要素タイプ

| タイプ | 抽出 | 書き換え | 備考 | |--------|:----:|:--------:|------| | テキスト | o | o | スタイル（フォント・色・太字等）完全保持 | | チャート | o | o | chart.replace_data() でデータのみ差し替え | | テーブル | o | o | セルスタイル保持、行列内容のみ差し替え | | 画像 | o | o | デフォルト保持、個別に差し替え指定可能 | | 図形 | o | o | 図形内テキストの差し替え | | グループ | o | o | 子要素を再帰的に処理（深さ3まで） | | SmartArt | o | 部分 | テキストノードのみXML直接操作で差し替え |

マッピングYAML構造

source: "source.pptx"
generated_at: "2026-02-09T15:30:00"
slide_width: 12192000
slide_height: 6858000

slides:
  - slide_number: 1
    layout: "Title Slide"
    elements:
      - id: 2
        name: "Title 1"
        type: text
        role: title
        hint: "メインタイトル。15-25文字。"
        position: { left: 457200, top: 274638, width: 8229600, height: 1143000 }
        style: { font: "Meiryo UI", size: 36, bold: true, color: "2563EB" }
        value: "2025年度 営業戦略"
        placeholder: "{{slide_1_title}}"

placeholders:
  - key: "{{slide_1_title}}"
    type: text
    role: title
    current: "2025年度 営業戦略"

ワークフロー判断

• **テンプレートPPTXがある** → `convert`（1コマンド完結）
• **マッピングを手動確認したい** → `extract` → YAML編集 → `build`
• **ゼロから作成** → `deck`

環境変数

• `GEMINI_API_KEY` or `GOOGLE_API_KEY`: Gemini API キー（必須）
• `GEMINI_FLASH_MODEL`: テキスト処理モデル（デフォルト: gemini-2.5-flash）