ppt-orchestra-skill

スライドページの種類（標準）

スライドごとに生成する場合（スライドごとに JS ファイルを 1 つ作成）、すべてのスライドを次の 5 つのページタイプのうち必ず 1 つだけに分類してください。これにより構成が一貫し、「ランダムなレイアウトのずれ」を防げます。

1. 表紙
   • 用途：開始と雰囲気づくり
   • 内容：大きなタイトル、副題／発表者、日付／イベント、印象的な背景／モチーフ
2. 目次
   • 用途：ナビゲーションと期待値の設定（3～5 セクション）
   • 内容：セクション一覧（任意でアイコン／ページ番号を追加）
3. セクション区切り
   • 用途：主要パート間の明確な切り替え
   • 内容：セクション番号＋タイトル（＋任意で 1～2 行の導入）
4. コンテンツページ（サブタイプを選択）
   • テキスト：箇条書き／引用／短い段落（アイコンや図形も追加してください）
   • 複合メディア：2 列レイアウト／画像を半分まで配置し、テキストを重ねる
   • データの可視化：グラフ＋1～3 個の重要なポイント＋出典
   • 比較：左右に並べた列／カード（A 対 B、長所／短所）
   • タイムライン／プロセス：矢印付きのステップ、流れ、フェーズ
   • 画像の紹介：メイン画像、ギャラリー、またはビジュアルを中心としたレイアウト
5. まとめ／クロージングページ
   • 用途：締めくくりと行動の促進
   • 内容：重要なポイント、CTA／次のステップ、連絡先／QR コード、お礼

レイアウトの選択肢：

• 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" の間隔を選び、一貫して使用してください
• 1 枚だけを装飾して、残りを質素なままにしない — 全体をしっかり装飾するか、全体をシンプルにまとめてください
• テキストだけのスライドを作らない — 画像、アイコン、グラフ、その他のビジュアル要素を追加し、タイトルと箇条書きだけの構成は避けてください
• テキストボックスの内側余白を忘れない — 行や図形の端をテキストの端に揃える場合は、テキストボックスに margin: 0 を設定するか、内側余白を考慮して図形の位置を調整してください
• コントラストの弱い要素を使わない — アイコンとテキストの両方で、背景に対して十分なコントラストを確保してください。明るい背景に明るいテキスト、暗い背景に暗いテキストを置くのは避けてください
• タイトルの下にアクセントラインを絶対に使わない — これは AI が生成したスライドによく見られる特徴です。代わりに余白や背景色を使ってください

スライドのコンパイル

slides/ 内のすべてのスライド JS ファイルを生成したら、slides/compile.js を作成して、それらを 1 つの PPTX にまとめます。

// slides/compile.js
const pptxgen = require('pptxgenjs');
const pres = new pptxgen();
pres.layout = 'LAYOUT_16x9';

const theme = {
  primary: "22223b",    // dark color for backgrounds/text
  secondary: "4a4e69",  // secondary accent
  accent: "9a8c98",     // highlight color
  light: "c9ada7",      // light accent
  bg: "f2e9e4"          // background color
};

for (let i = 1; i <= 12; i++) {  // adjust count as needed
  const num = String(i).padStart(2, '0');
  const slideModule = require(`./slide-${num}.js`);
  slideModule.createSlide(pres, theme);
}

pres.writeFile({ fileName: './output/presentation.pptx' });

次のコマンドで実行します：cd slides && node compile.js

---

QA（必須）

問題があることを前提にしてください。問題を見つけるのがあなたの役目です。

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

コンテンツの QA

python -m markitdown output.pptx

コンテンツの欠落、誤字、順序の間違いがないか確認してください。

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

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

grep で結果が返された場合は、問題がないと判断する前に修正してください。

検証ループ

1. スライドを生成 → python -m markitdown output.pptx でテキストを抽出 → コンテンツを確認
2. 見つかった問題を列挙する（問題が見つからなかった場合は、さらに批判的に見直してください）
3. 問題を修正する
4. 影響を受けたスライドを再検証する — ひとつ修正すると、別の問題が生じることがよくあります
5. 新たな問題が見つからない状態で全体を一巡するまで繰り返す

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

---

依存関係

• pip install "markitdown[pptx]" - テキスト抽出
• npm install -g pptxgenjs - ゼロから作成