PPTX ジェネレーター＆エディター

概要

このスキルは、PowerPoint のすべてのタスクに対応します：既存プレゼンテーションの読込・分析、XML 操作によるテンプレートベースのデッキ編集、PptxGenJS を使用したプレゼンテーションのゼロからの作成。完全なデザインシステム（カラーパレット、フォント、スタイルレシピ）と、すべてのスライドタイプに対する詳細なガイダンスを含みます。

クイックリファレンス

タスク	アプローチ
コンテンツを読込・分析	python -m markitdown presentation.pptx
テンプレートから編集または作成	プレゼンテーションの編集を参照
ゼロから作成	下記のゼロから作成ワークフローを参照

項目	値
寸法	10" x 5.625" (LAYOUT_16x9)
色	6 文字の 16 進数（# なし、例："FF0000")
英文フォント	Arial（デフォルト）、または承認された代替フォント
中国語フォント	Microsoft YaHei
ページバッジ位置	x: 9.3", y: 5.1"
テーマキー	primary、secondary、accent、light、bg
図形	RECTANGLE、OVAL、LINE、ROUNDED_RECTANGLE
グラフ	BAR、LINE、PIE、DOUGHNUT、SCATTER、BUBBLE、RADAR

リファレンスファイル

ファイル	内容
slide-types.md	5 つのスライドページタイプ（カバー、目次、セクション区切り、コンテンツ、要約）+ 追加レイアウトパターン
design-system.md	カラーパレット、フォントリファレンス、スタイルレシピ（Sharp/Soft/Rounded/Pill）、タイポグラフィ & スペーシング
editing.md	テンプレートベースの編集ワークフロー、XML 操作、フォーマット規則、よくある落とし穴
pitfalls.md	QA プロセス、よくあるミス、重大な PptxGenJS の落とし穴
pptxgenjs.md	完全な PptxGenJS API リファレンス

---

コンテンツの読込

# テキスト抽出
python -m markitdown presentation.pptx

---

ゼロから作成 — ワークフロー

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

ステップ 1：リサーチと要件確認

ユーザーの要件を理解するために検索します — トピック、対象者、目的、トーン、コンテンツの深さ。

ステップ 2：カラーパレットとフォントを選択

カラーパレットリファレンスを使用して、トピックと対象者に合致するパレットを選択します。フォントリファレンスを使用して、フォントペアリングを選択します。

ステップ 3：デザインスタイルを選択

スタイルレシピを使用して、プレゼンテーションのトーンに合致するビジュアルスタイル（Sharp、Soft、Rounded、または Pill）を選択します。

ステップ 4：スライドアウトラインを計画

すべてのスライドを5 つのページタイプのいずれか 1 つに正確に分類します。各スライドのコンテンツとレイアウトを計画します。視覚的多様性を確保します — スライド全体で同じレイアウトを繰り返さないでください。

ステップ 5：スライド JS ファイルを生成

slides/ ディレクトリにスライドごとに 1 つの JS ファイルを作成します。各ファイルは同期的な createSlide(pres, theme) 関数をエクスポートする必要があります。スライド出力フォーマットに従い、slide-types.mdのタイプ固有のガイダンスに従います。サブエージェントが利用可能な場合は、最大 5 つのスライドを並行して生成します。

各サブエージェントに以下を指示します：

1. ファイル命名：slides/slide-01.js、slides/slide-02.js など
2. 画像ディレクトリ：slides/imgs/
3. 最終 PPTX 出力先：slides/output/
4. 寸法：10" x 5.625"（LAYOUT_16x9）
5. フォント：中国語 = Microsoft YaHei、英文 = Arial（または承認された代替フォント）
6. 色：6 文字の 16 進数（# なし、例："FF0000")
7. テーマオブジェクトコントラクトを使用する必要があります（テーマオブジェクトコントラクトを参照）
8. PptxGenJS API リファレンスに従う必要があります

ステップ 6：最終 PPTX にコンパイル

すべてのスライドモジュールを結合する slides/compile.js を作成します：

// 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

ステップ 7：QA（必須）

QA プロセスを参照してください。

出力構造

slides/
├── slide-01.js          # スライドモジュール
├── slide-02.js
├── ...
├── imgs/                # スライドで使用される画像
└── output/              # 最終成果物
    └── presentation.pptx

---

スライド出力フォーマット

各スライドは完全で実行可能な JS ファイルです：

// slide-01.js
const pptxgen = require("pptxgenjs");

const slideConfig = {
  type: 'cover',
  index: 1,
  title: 'Presentation Title'
};

// 同期的である必要があります（async ではない）
function createSlide(pres, theme) {
  const slide = pres.addSlide();
  slide.background = { color: theme.bg };

  slide.addText(slideConfig.title, {
    x: 0.5, y: 2, w: 9, h: 1.2,
    fontSize: 48, fontFace: "Arial",
    color: theme.primary, bold: true, align: "center"
  });

  return slide;
}

// スタンドアロンプレビュー - スライド固有のファイル名を使用
if (require.main === module) {
  const pres = new pptxgen();
  pres.layout = 'LAYOUT_16x9';
  const theme = {
    primary: "22223b",
    secondary: "4a4e69",
    accent: "9a8c98",
    light: "c9ada7",
    bg: "f2e9e4"
  };
  createSlide(pres, theme);
  pres.writeFile({ fileName: "slide-01-preview.pptx" });
}

module.exports = { createSlide, slideConfig };

---

テーマオブジェクトコントラクト（必須）

コンパイルスクリプトは、これらの正確なキーを持つテーマオブジェクトを渡します：

キー	目的	例
theme.primary	最暗色、タイトル	"22223b"
theme.secondary	暗いアクセント、本文	"4a4e69"
theme.accent	ミッドトーンアクセント	"9a8c98"
theme.light	ライトアクセント	"c9ada7"
theme.bg	背景色	"f2e9e4"

background、text、muted、darkest、lightest などの他のキー名を使用しないでください。

---

ページ番号バッジ（必須）

カバーページを除くすべてのスライドには、右下隅にページ番号バッジを含める必要があります。

• 位置：x: 9.3"、y: 5.1"
• 現在の番号のみを表示（例：3 または 03）、「3/12」ではない
• パレット色を使用し、控えめに保つ

サークルバッジ（デフォルト）

slide.addShape(pres.shapes.OVAL, {
  x: 9.3, y: 5.1, w: 0.4, h: 0.4,
  fill: { color: theme.accent }
});
slide.addText("3", {
  x: 9.3, y: 5.1, w: 0.4, h: 0.4,
  fontSize: 12, fontFace: "Arial",
  color: "FFFFFF", bold: true,
  align: "center", valign: "middle"
});

ピルバッジ

slide.addShape(pres.shapes.ROUNDED_RECTANGLE, {
  x: 9.1, y: 5.15, w: 0.6, h: 0.35,
  fill: { color: theme.accent },
  rectRadius: 0.15
});
slide.addText("03", {
  x: 9.1, y: 5.15, w: 0.6, h: 0.35,
  fontSize: 11, fontFace: "Arial",
  color: "FFFFFF", bold: true,
  align: "center", valign: "middle"
});

---

依存関係

• pip install "markitdown[pptx]" — テキスト抽出
• npm install -g pptxgenjs — ゼロからの作成
• npm install -g react-icons react react-dom sharp — アイコン（オプション）