PPT Template Creator

このスキルはプレゼンテーションではなくSKILLを作成します。 ユーザーがPowerPointテンプレートを後でプレゼンテーション生成に使用できる再利用可能なスキルに変換したい場合に使用してください。ユーザーがプレゼンテーションを作成するだけの場合は、pptxスキルを使用してください。

生成されるスキルには以下が含まれます:

• assets/template.pptx - テンプレートファイル
• SKILL.md - 完全な説明書（このメタスキルへの参照は不要）

スキル構築の一般的なベストプラクティスについては、skill-creatorスキルを参照してください。このスキルはPPT固有のパターンに焦点を当てています。

ワークフロー

1. ユーザーがテンプレートを提供 (.pptx または .potx)
2. テンプレートを分析 - レイアウト、プレースホルダー、寸法を抽出
3. スキルを初期化 - skill-creatorスキルを使用してスキル構造をセットアップ
4. テンプレートを追加 - .pptxをassets/template.pptxにコピー
5. SKILL.mdを作成 - 以下のテンプレートに従い、PPT固有の詳細を記入
6. 例を作成 - サンプルプレゼンテーションを生成して検証
7. パッケージ化 - skill-creatorスキルを使用して.skillファイルにパッケージ化

ステップ2: テンプレートを分析

重要: プレースホルダーの正確な位置を抽出します - これによってコンテンツ領域の境界が決まります。

from pptx import Presentation

prs = Presentation(template_path)
print(f"Dimensions: {prs.slide_width/914400:.2f}\" x {prs.slide_height/914400:.2f}\"")
print(f"Layouts: {len(prs.slide_layouts)}")

for idx, layout in enumerate(prs.slide_layouts):
    print(f"\n[{idx}] {layout.name}:")
    for ph in layout.placeholders:
        try:
            ph_idx = ph.placeholder_format.idx
            ph_type = ph.placeholder_format.type
            # 重要: インチ単位で正確な位置を抽出
            left = ph.left / 914400
            top = ph.top / 914400
            width = ph.width / 914400
            height = ph.height / 914400
            print(f"    idx={ph_idx}, type={ph_type}")
            print(f"        x={left:.2f}\", y={top:.2f}\", w={width:.2f}\", h={height:.2f}\"")
        except:
            pass

記録すべき主要な測定値:

• タイトル位置: タイトルプレースホルダーはどこに位置していますか?
• サブタイトル/説明: サブタイトル行はどこにありますか?
• フッタープレースホルダー: フッター/ソースはどこに表示されますか?
• コンテンツ領域: サブタイトルとフッターの間のスペースがコンテンツ領域です

真のコンテンツ開始位置を見つける

重要: コンテンツ領域は必ずしもサブタイトルプレースホルダーの直後に始まるわけではありません。多くのテンプレートには、サブタイトルとコンテンツ領域の間に視覚的な境界線、線、または予約スペースがあります。

最適なアプローチ: レイアウト2またはOBJECTプレースホルダーを持つ同様の「コンテンツ」レイアウトを確認します - このプレースホルダーのy位置がコンテンツが実際に開始すべき場所を示しています。

# OBJECTプレースホルダーを見つけて、真のコンテンツ開始位置を決定
for idx, layout in enumerate(prs.slide_layouts):
    for ph in layout.placeholders:
        try:
            if ph.placeholder_format.type == 7:  # OBJECTタイプ
                top = ph.top / 914400
                print(f"Layout [{idx}] {layout.name}: OBJECT starts at y={top:.2f}\"")
                # このy値がコンテンツが実際に開始すべき場所です!
        except:
            pass

例: テンプレートは以下のようになっている可能性があります:

• サブタイトルがy=1.38"で終了
• ただしOBJECTプレースホルダーがy=1.90"で開始
• ギャップ(0.52")は境界線/線用に予約されています - そこにコンテンツを配置しないでください

サブタイトルの終了位置ではなく、OBJECTプレースホルダーのy位置をコンテンツ開始として使用します。

ステップ5: SKILL.mdを作成

生成されたスキルは以下の構造を持つ必要があります:

[company]-ppt-template/
├── SKILL.md
└── assets/
    └── template.pptx

生成されたSKILL.mdテンプレート

生成されたSKILL.mdは自己完結型で、すべての説明書が組み込まれている必要があります。このテンプレートを使用して、分析から角括弧の値を埋めてください:

---
name: [company]-ppt-template
description: プレゼンテーション作成用の[Company] PowerPointテンプレート。[Company]ブランドのピッチデック、取締役会資料、またはクライアントプレゼンテーション作成時に使用します。
---

# [Company] PPTテンプレート

テンプレート: `assets/template.pptx` ([WIDTH]" x [HEIGHT]", [N]レイアウト)

## プレゼンテーション作成方法

```python
from pptx import Presentation

prs = Presentation("path/to/skill/assets/template.pptx")

# 既存スライドをすべて削除
while len(prs.slides) > 0:
    rId = prs.slides._sldIdLst[0].rId
    prs.part.drop_rel(rId)
    del prs.slides._sldIdLst[0]

# レイアウトからスライドを追加
slide = prs.slides.add_slide(prs.slide_layouts[LAYOUT_IDX])
```

## 主要なレイアウト

| インデックス | 名前 | 用途 |
|-------|------|---------|
| [0] | [レイアウト名] | [カバー/タイトルスライド] |
| [N] | [レイアウト名] | [箇条書き付きコンテンツ] |
| [N] | [レイアウト名] | [2カラムレイアウト] |

## プレースホルダーマッピング

**重要: 各プレースホルダーの正確な位置（x、y座標）を含めます。**

### レイアウト [N]: [名前]
| idx | タイプ | 位置 | 用途 |
|-----|------|----------|-----|
| [idx] | TITLE (1) | y=[Y]" | スライドタイトル |
| [idx] | BODY (2) | y=[Y]" | サブタイトル/説明 |
| [idx] | BODY (2) | y=[Y]" | フッター |
| [idx] | BODY (2) | y=[Y]" | ソース/注記 |

### コンテンツ領域の境界

**カスタム図形/表/グラフのための安全なコンテンツ領域をドキュメント化:**

```
コンテンツ領域 (レイアウト [N]用):
- 左マージン: [X]" (コンテンツがここから始まります)
- 上部: [Y]" (サブタイトルプレースホルダーの下)
- 幅: [W]"
- 高さ: [H]" (フッター前に終了)

4象限レイアウトの場合:
- 左列: x=[X]", 幅=[W]"
- 右列: x=[X]", 幅=[W]"
- 上行: y=[Y]", 高さ=[H]"
- 下行: y=[Y]", 高さ=[H]"
```

**なぜこれが重要か:** カスタムコンテンツ（テキストボックス、表、グラフ）は、タイトル、フッター、ソース行などのテンプレートプレースホルダーと重ならないようにこれらの境界内に留める必要があります。

## コンテンツを埋める

**手動で箇条書き文字を追加しないでください** - スライドマスターが書式を処理します。

```python
# タイトルを埋める
for shape in slide.shapes:
    if hasattr(shape, 'placeholder_format'):
        if shape.placeholder_format.type == 1:  # TITLE
            shape.text = "Slide Title"

# 階層構造でコンテンツを埋める (レベル0 = ヘッダー、レベル1 = 箇条書き)
for shape in slide.shapes:
    if hasattr(shape, 'placeholder_format'):
        idx = shape.placeholder_format.idx
        if idx == [CONTENT_IDX]:
            tf = shape.text_frame
            for para in tf.paragraphs:
                para.clear()

            content = [
                ("Section Header", 0),
                ("First bullet point", 1),
                ("Second bullet point", 1),
            ]

            tf.paragraphs[0].text = content[0][0]
            tf.paragraphs[0].level = content[0][1]
            for text, level in content[1:]:
                p = tf.add_paragraph()
                p.text = text
                p.level = level
```

## 例: カバースライド

```python
slide = prs.slides.add_slide(prs.slide_layouts[[COVER_IDX]])
for shape in slide.shapes:
    if hasattr(shape, 'placeholder_format'):
        idx = shape.placeholder_format.idx
        if idx == [TITLE_IDX]:
            shape.text = "Company Name"
        elif idx == [SUBTITLE_IDX]:
            shape.text = "Presentation Title | Date"
```

## 例: コンテンツスライド

```python
slide = prs.slides.add_slide(prs.slide_layouts[[CONTENT_IDX]])
for shape in slide.shapes:
    if hasattr(shape, 'placeholder_format'):
        ph_type = shape.placeholder_format.type
        idx = shape.placeholder_format.idx
        if ph_type == 1:
            shape.text = "Executive Summary"
        elif idx == [BODY_IDX]:
            tf = shape.text_frame
            for para in tf.paragraphs:
                para.clear()
            content = [
                ("Key Findings", 0),
                ("Revenue grew 40% YoY to $50M", 1),
                ("Expanded to 3 new markets", 1),
                ("Recommendation", 0),
                ("Proceed with strategic initiative", 1),
            ]
            tf.paragraphs[0].text = content[0][0]
            tf.paragraphs[0].level = content[0][1]
            for text, level in content[1:]:
                p = tf.add_paragraph()
                p.text = text
                p.level = level
```

ステップ6: 出力例を作成

サンプルプレゼンテーションを生成して、スキルが機能することを検証します。参照用にスキルの隣に保存します。

生成されたスキルのPPT固有ルール

1. assets/内のテンプレート - 常に.pptxファイルをバンドル
2. 自己完結型のSKILL.md - すべての説明書が組み込まれ、外部参照なし
3. 手動箇条書きなし - 階層構造にparagraph.levelを使用
4. スライドを最初に削除 - 新しいスライドを追加する前に常に既存スライドをクリア
5. プレースホルダーをidxでドキュメント化 - プレースホルダーidx値はテンプレート固有です