pptx

PPTX スキル

クイックリファレンス

タスク	ガイド
コンテンツの読み取り・分析	python -m markitdown presentation.pptx
テンプレートからの編集または作成	editing.md を読む
ゼロからの作成	pptxgenjs.md を読む

---

コンテンツの読み取り

# Text extraction
python -m markitdown presentation.pptx

# Visual overview
python scripts/thumbnail.py presentation.pptx

# Raw XML
python scripts/office/unpack.py presentation.pptx unpacked/

---

編集ワークフロー

詳細は editing.md を参照してください。

1. thumbnail.py でテンプレートを分析する
2. アンパック → スライドを操作 → コンテンツを編集 → クリーン → パック

---

ゼロからの作成

詳細は pptxgenjs.md を参照してください。

テンプレートや参照用のプレゼンテーションがない場合に使用します。

---

デザインのアイデア

退屈なスライドは作らないでください。 白い背景に単純な箇条書きを並べただけでは、誰の印象にも残りません。各スライドについて、このリストのアイデアを検討してください。

開始する前に

• 内容に合った大胆なカラーパレットを選ぶ: パレットは、このトピックのために設計されたものに感じられる必要があります。色を完全に別のプレゼンテーションに入れ替えても「うまくいく」のであれば、十分に具体的な選択ができていません。
• 均等ではなく支配的な色を置く: 1つの色が視覚的な重み（60〜70%）を占め、1〜2色のサポート色と、鋭いアクセント色を1つ加えます。すべての色に同じ重みを与えないでください。
• ダークとライトのコントラスト: タイトルとまとめのスライドにはダーク背景、コンテンツにはライトを使う（「サンドイッチ」構成）。または、プレミアムな印象のために全体をダークで統一します。
• ビジュアルモチーフを一貫させる: 特徴的な要素を1つ選んで繰り返し使います。例えば、角丸の画像フレーム、色付きの円の中のアイコン、片側の太い罫線などです。すべてのスライドに一貫して用いてください。

カラーパレット

トピックに合った色を選んでください。一般的な青をそのまま使わないようにしましょう。以下のパレットをインスピレーションとして使えます。

テーマ	プライマリ	セカンダリ	アクセント
Midnight Executive	1E2761（ネイビー）	CADCFC（アイスブルー）	FFFFFF（ホワイト）
Forest & Moss	2C5F2D（フォレスト）	97BC62（モス）	F5F5F5（クリーム）
Coral Energy	F96167（コーラル）	F9E795（ゴールド）	2F3C7E（ネイビー）
Warm Terracotta	B85042（テラコッタ）	E7E8D1（サンド）	A7BEAE（セージ）
Ocean Gradient	065A82（ディープブルー）	1C7293（ティール）	21295C（ミッドナイト）
Charcoal Minimal	36454F（チャコール）	F2F2F2（オフホワイト）	212121（ブラック）
Teal Trust	028090（ティール）	00A896（シーフォーム）	02C39A（ミント）
Berry & Cream	6D2E46（ベリー）	A26769（ダスティローズ）	ECE2D0（クリーム）
Sage Calm	84B59F（セージ）	69A297（ユーカリ）	50808E（スレート）
Cherry Bold	990011（チェリー）	FCF6F5（オフホワイト）	2F3C7E（ネイビー）

各スライドについて

すべてのスライドにはビジュアル要素が必要です。 画像、グラフ、アイコン、または図形のいずれかを入れてください。テキストだけのスライドは印象に残りません。

レイアウトの選択肢:

• 2カラム（左にテキスト、右にイラスト）
• アイコン＋テキストの行（色付きの円の中のアイコン、太字の見出し、その下に説明）
• 2x2 または 2x3 のグリッド（片側に画像、もう片側にコンテンツブロックのグリッド）
• ハーフブリード画像（左または右の全面）にコンテンツを重ねる

データの表示:

• 大きな数値の強調表示（60〜72pt の大きな数字と、その下の小さなラベル）
• 比較列（前後、長所と短所、並列のオプション）
• タイムラインまたはプロセスフロー（番号付きステップ、矢印）

ビジュアルの仕上げ:

• セクション見出しの横に、小さな色付きの円に入れたアイコンを置く
• 重要な数値やキャッチコピーには斜体のアクセントテキストを使う

タイポグラフィ

興味深いフォントの組み合わせを選んでください。 Arial をそのまま使わないようにしましょう。個性のある見出し用フォントを選び、それを読みやすい本文用フォントと組み合わせます。

見出しフォント	本文フォント
Georgia	Calibri
Arial Black	Arial
Calibri	Calibri Light
Cambria	Calibri
Trebuchet MS	Calibri
Impact	Arial
Palatino	Garamond
Consolas	Calibri

要素	サイズ
スライドタイトル	36〜44pt 太字
セクション見出し	20〜24pt 太字
本文	14〜16pt
キャプション	10〜12pt（控えめな色）

余白

• 最低 0.5" の余白
• コンテンツブロック間は 0.3〜0.5"
• 余白を残してください。すべての空間を埋めないようにしましょう

避けるべきこと（よくある間違い）

• 同じレイアウトを繰り返さない — スライドごとに列、カード、コールアウトの構成を変えてください
• 本文を中央揃えにしない — 段落やリストは左揃えにし、中央揃えはタイトルだけに使ってください
• サイズのコントラストを軽視しない — タイトルは、14〜16pt の本文と区別するために 36pt 以上にしてください
• デフォルトで青を使わない — そのトピックを表す色を選んでください
• 間隔をばらばらに混在させない — 0.3" か 0.5" のいずれかの間隔を選び、一貫して使ってください
• 一部のスライドだけ装飾して残りを簡素なままにしない — 全面的に装飾するか、全体を簡素にしてください
• テキストだけのスライドを作らない — 画像、アイコン、グラフ、その他の視覚要素を加えてください。タイトルと箇条書きだけの構成は避けてください
• テキストボックスの余白を忘れない — 線や図形をテキストの端に揃える場合は、テキストボックスに margin: 0 を設定するか、余白分を考慮して図形の位置をずらしてください
• コントラストの低い要素を使わない — アイコンとテキストは、背景に対して十分なコントラストが必要です。明るい背景に明るい文字、暗い背景に暗い文字を置くことは避けてください
• タイトルの下に アクセント線を入れることは絶対にしない — これは AI で生成されたスライドに特徴的な要素です。代わりに余白や背景色を使ってください

---

QA（必須）

問題があると想定してください。あなたの仕事はそれを見つけることです。

最初のレンダリング結果が正しいことはほとんどありません。QA は確認作業ではなく、バグ探しとして取り組んでください。最初の確認で問題が一つも見つからなかったなら、十分に注意深く見ていなかったということです。

コンテンツの QA

python -m markitdown output.pptx

内容の欠落、誤字、順序の誤りがないか確認してください。

テンプレートを使用している場合は、プレースホルダーの文字が残っていないか確認してください：

python -m markitdown output.pptx | grep -iE "xxxx|lorem|ipsum|this.*(page|slide).*layout"

grep で結果が出力された場合は、成功と判断する前に修正してください。

ビジュアルの QA

⚠️ サブエージェントを使用してください — 2〜3 枚のスライドだけでも同様です。あなたはコードを見続けているため、期待している内容を見てしまい、実際の内容を見落とします。サブエージェントは新鮮な目で確認できます。

スライドを画像に変換し（画像への変換 を参照）、次のプロンプトを使用してください：

Visually inspect these slides. Assume there are issues — find them.

Look for:
- Overlapping elements (text through shapes, lines through words, stacked elements)
- Text overflow or cut off at edges/box boundaries
- Decorative lines positioned for single-line text but title wrapped to two lines
- Source citations or footers colliding with content above
- Elements too close (< 0.3" gaps) or cards/sections nearly touching
- Uneven gaps (large empty area in one place, cramped in another)
- Insufficient margin from slide edges (< 0.5")
- Columns or similar elements not aligned consistently
- Low-contrast text (e.g., light gray text on cream-colored background)
- Low-contrast icons (e.g., dark icons on dark backgrounds without a contrasting circle)
- Text boxes too narrow causing excessive wrapping
- Leftover placeholder content

For each slide, list issues or areas of concern, even if minor.

Read and analyze these images:
1. /path/to/slide-01.jpg (Expected: [brief description])
2. /path/to/slide-02.jpg (Expected: [brief description])

Report ALL issues found, including minor ones.

検証ループ

1. スライドを生成 → 画像に変換 → 確認
2. 見つかった問題を列挙する（問題が見つからなければ、より批判的な目で再確認する）
3. 問題を修正する
4. 影響を受けたスライドを再検証する — 一つの修正が別の問題を生むことがよくあります
5. 新たな問題が見つからない完全な確認が一回通るまで繰り返す

少なくとも一回、修正と検証のサイクルを完了するまで、成功を宣言しないでください。

---

画像への変換

プレゼンテーションを目視確認用に個別のスライド画像へ変換します：

python scripts/office/soffice.py --headless --convert-to pdf output.pptx
pdftoppm -jpeg -r 150 output.pdf slide

これにより slide-01.jpg、slide-02.jpg などが作成されます。

修正後に特定のスライドを再レンダリングする場合：

pdftoppm -jpeg -r 150 -f N -l N output.pdf slide-fixed

---

依存関係

• pip install "markitdown[pptx]" - テキスト抽出
• pip install Pillow - サムネイルグリッド
• npm install -g pptxgenjs - ゼロからの作成
• LibreOffice (soffice) - PDF 変換（サンドボックス環境では scripts/office/soffice.py により自動設定されます）
• Poppler (pdftoppm) - PDF から画像への変換