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つ選び、繰り返し使います。たとえば、角丸の画像フレーム、色付きの円の中のアイコン、片側だけの太い枠線などです。すべてのスライドで統一して使いましょう。

カラーパレット

トピックに合う色を選び、一般的な青をデフォルトにしないでください。次のパレットを参考にしてください。

テーマ	プライマリ	セカンダリ	アクセント
ミッドナイト・エグゼクティブ	1E2761（ネイビー）	CADCFC（アイスブルー）	FFFFFF（白）
フォレスト＆モス	2C5F2D（フォレスト）	97BC62（モス）	F5F5F5（クリーム）
コーラル・エナジー	F96167（コーラル）	F9E795（ゴールド）	2F3C7E（ネイビー）
ウォーム・テラコッタ	B85042（テラコッタ）	E7E8D1（サンド）	A7BEAE（セージ）
オーシャン・グラデーション	065A82（ディープブルー）	1C7293（ティール）	21295C（ミッドナイト）
チャコール・ミニマル	36454F（チャコール）	F2F2F2（オフホワイト）	212121（黒）
ティール・トラスト	028090（ティール）	00A896（シーフォーム）	02C39A（ミント）
ベリー＆クリーム	6D2E46（ベリー）	A26769（ダスティローズ）	ECE2D0（クリーム）
セージ・カーム	84B59F（セージ）	69A297（ユーカリ）	50808E（スレート）
チェリー・ボールド	990011（チェリー）	FCF6F5（オフホワイト）	2F3C7E（ネイビー）

各スライドについて

すべてのスライドに視覚要素が必要です。画像、グラフ、アイコン、図形などを使いましょう。テキストだけのスライドは印象に残りません。

レイアウトの選択肢：

• 2カラム（左にテキスト、右にイラスト）
• アイコン＋テキストの行（色付きの円の中のアイコン、太字の見出し、その下に説明）
• 2×2または2×3のグリッド（片側に画像、もう片側にコンテンツブロックのグリッド）
• コンテンツを重ねた全面画像（左右どちらかの半分を画像で覆う）

データの表示：

• 数値を大きく強調するコールアウト（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 から画像への変換