canghe-slide-deck

スライドデッキジェネレーター

コンテンツをプロフェッショナルなスライドデッキ画像に変換します。

使用方法

/canghe-slide-deck path/to/content.md
/canghe-slide-deck path/to/content.md --style sketch-notes
/canghe-slide-deck path/to/content.md --audience executives
/canghe-slide-deck path/to/content.md --lang zh
/canghe-slide-deck path/to/content.md --slides 10
/canghe-slide-deck path/to/content.md --outline-only
/canghe-slide-deck  # Then paste content

スクリプトディレクトリ

エージェント実行手順：

1. この SKILL.md ファイルのディレクトリパスを SKILL_DIR として特定します
2. スクリプトのパス = ${SKILL_DIR}/scripts/<script-name>.ts

スクリプト	用途
scripts/merge-to-pptx.ts	スライドをPowerPointに結合
scripts/merge-to-pdf.ts	スライドをPDFに結合

オプション

オプション	説明
--style <name>	ビジュアルスタイル：プリセット名、custom、またはカスタムスタイル名
--audience <type>	対象：初心者、中級者、エキスパート、経営幹部、一般
--lang <code>	出力言語（en、zh、jaなど）
--slides <number>	スライドの目標枚数（8～25枚を推奨、最大30枚）
--outline-only	アウトラインのみを生成し、画像生成をスキップ
--prompts-only	アウトラインとプロンプトを生成し、画像生成をスキップ
--images-only	既存のプロンプトディレクトリから画像を生成
--regenerate <N>	特定のスライドを再生成：--regenerate 3 または --regenerate 2,5,8

コンテンツの長さに応じたスライド枚数：

コンテンツ	スライド
< 1000語	5～10
1000～3000語	10～18
3000～5000語	15～25
> 5000語	20～30（分割を検討）

スタイルシステム

プリセット

プリセット	特徴	最適な用途
blueprint（デフォルト）	グリッド + 寒色 + 技術的 + バランス型	アーキテクチャ、システム設計
chalkboard	有機的 + 暖色 + 手書き風 + バランス型	教育、チュートリアル
corporate	クリーン + プロフェッショナル + 幾何学的 + バランス型	投資家向け資料、提案書
minimal	クリーン + ニュートラル + 幾何学的 + ミニマル	経営幹部向け説明資料
sketch-notes	有機的 + 暖色 + 手書き風 + バランス型	教育、チュートリアル
watercolor	有機的 + 暖色 + ヒューマニスト + ミニマル	ライフスタイル、ウェルネス
dark-atmospheric	クリーン + ダーク + エディトリアル + バランス型	エンターテインメント、ゲーム
notion	クリーン + ニュートラル + 幾何学的 + 高密度	製品デモ、SaaS
bold-editorial	クリーン + 鮮やか + エディトリアル + バランス型	製品発表、基調講演
editorial-infographic	クリーン + 寒色 + エディトリアル + 高密度	技術解説、研究
fantasy-animation	有機的 + 鮮やか + 手書き風 + ミニマル	教育的なストーリーテリング
intuition-machine	クリーン + 寒色 + 技術的 + 高密度	技術文書、学術
pixel-art	ピクセル + 鮮やか + 技術的 + バランス型	ゲーム、開発者向け講演
scientific	クリーン + 寒色 + 技術的 + 高密度	生物学、化学、医療
vector-illustration	クリーン + 鮮やか + ヒューマニスト + バランス型	クリエイティブ、子ども向けコンテンツ
vintage	ペーパー + 暖色 + エディトリアル + バランス型	歴史、伝統

スタイルの次元

次元	選択肢	説明
テクスチャ	クリーン、グリッド、有機的、ピクセル、ペーパー	ビジュアルテクスチャと背景の処理
ムード	プロフェッショナル、暖色、寒色、鮮やか、ダーク、ニュートラル	色温度とパレットのスタイル
タイポグラフィ	幾何学的、ヒューマニスト、手書き風、エディトリアル、技術的	見出しと本文のテキストスタイル
密度	ミニマル、バランス型、高密度	スライドあたりの情報密度

詳細な仕様：references/dimensions/*.md

自動スタイル選択

コンテンツの特徴	プリセット
tutorial, learn, education, guide, beginner	sketch-notes
classroom, teaching, school, chalkboard	chalkboard
architecture, system, data, analysis, technical	blueprint
creative, children, kids, cute	vector-illustration
briefing, academic, research, bilingual	intuition-machine
executive, minimal, clean, simple	minimal
saas, product, dashboard, metrics	notion
investor, quarterly, business, corporate	corporate
launch, marketing, keynote, magazine	bold-editorial
entertainment, music, gaming, atmospheric	dark-atmospheric
explainer, journalism, science communication	editorial-infographic
story, fantasy, animation, magical	fantasy-animation
gaming, retro, pixel, developer	pixel-art
biology, chemistry, medical, scientific	scientific
history, heritage, vintage, expedition	vintage
lifestyle, wellness, travel, artistic	watercolor
デフォルト	blueprint

デザイン哲学

ライブプレゼンテーションではなく、閲覧と共有を目的としたデッキです。

• 各スライドは、口頭での説明がなくても理解できます
• スクロールしても論理的な流れを保ちます
• 必要なコンテキストを各スライドに含めます
• ソーシャルメディアでの共有に最適化されています

以下を参照してください：references/design-guidelines.md

• 対象者に応じた原則
• 視覚的な階層
• コンテンツ密度のガイドライン
• 色とタイポグラフィの選択
• フォントの推奨事項

レイアウトの選択肢については、references/layouts.mdを参照してください。

ファイル管理

出力ディレクトリ

slide-deck/{topic-slug}/
├── source-{slug}.{ext}
├── outline.md
├── prompts/
│   └── 01-slide-cover.md, 02-slide-{slug}.md, ...
├── 01-slide-cover.png, 02-slide-{slug}.png, ...
├── {topic-slug}.pptx
└── {topic-slug}.pdf

スラッグ：トピックを抽出します（2～4語、ケバブケース）。例：「機械学習入門」→ intro-machine-learning

競合の処理：既存コンテンツの検出とユーザーの選択肢については、ステップ1.3を参照してください。

言語の処理

検出の優先順位：

1. --langフラグ（明示的な指定）
2. EXTEND.mdのlanguage設定
3. ユーザーの会話言語（入力言語）
4. ソースコンテンツの言語

ルール：すべての応答で、ユーザーが希望する言語を使用します。

• 質問と確認
• 進捗レポート
• エラーメッセージ
• 完了の概要

専門用語（スタイル名、ファイルパス、コード）は英語のままにします。

ワークフロー

このチェックリストをコピーし、完了した項目にチェックを入れてください。

Slide Deck Progress:
- [ ] Step 1: Setup & Analyze
  - [ ] 1.1 Load preferences
  - [ ] 1.2 Analyze content
  - [ ] 1.3 Check existing ⚠️ REQUIRED
- [ ] Step 2: Confirmation ⚠️ REQUIRED (Round 1, optional Round 2)
- [ ] Step 3: Generate outline
- [ ] Step 4: Review outline (conditional)
- [ ] Step 5: Generate prompts
- [ ] Step 6: Review prompts (conditional)
- [ ] Step 7: Generate images
- [ ] Step 8: Merge to PPTX/PDF
- [ ] Step 9: Output summary

フロー

Input → Preferences → Analyze → [Check Existing?] → Confirm (1-2 rounds) → Outline → [Review Outline?] → Prompts → [Review Prompts?] → Images → Merge → Complete

ステップ 1：セットアップと分析

1.1 設定を読み込む（EXTEND.md）

Bash を使って、優先順位に従い EXTEND.md が存在するか確認します。

# Check project-level first
test -f .canghe-skills/canghe-slide-deck/EXTEND.md && echo "project"

# Then user-level (cross-platform: $HOME works on macOS/Linux/WSL)
test -f "$HOME/.canghe-skills/canghe-slide-deck/EXTEND.md" && echo "user"

┌──────────────────────────────────────────────────┬───────────────────┐ │ パス │ 場所 │ ├──────────────────────────────────────────────────┼───────────────────┤ │ .canghe-skills/canghe-slide-deck/EXTEND.md │ プロジェクトディレクトリ │ ├──────────────────────────────────────────────────┼───────────────────┤ │ $HOME/.canghe-skills/canghe-slide-deck/EXTEND.md │ ユーザーホーム │ └──────────────────────────────────────────────────┴───────────────────┘

EXTEND.md が見つかった場合 → 読み込んで解析し、ユーザーに概要を出力します。

📋 Loaded preferences from [full path]
├─ Style: [preset/custom name]
├─ Audience: [audience or "auto-detect"]
├─ Language: [language or "auto-detect"]
└─ Review: [enabled/disabled]

EXTEND.md が見つからない場合 → AskUserQuestion を使って初回セットアップを行うか、デフォルト設定で進めます。

EXTEND.md で設定できる項目：希望するスタイル｜カスタム寸法｜デフォルトの対象読者｜言語設定｜レビュー設定

スキーマ：references/config/preferences-schema.md

1.2 コンテンツを分析する

1. ソースコンテンツを保存します（貼り付けられた場合は、source.md として保存します）
   • バックアップルール：source.md が存在する場合は、source-backup-YYYYMMDD-HHMMSS.md に名前を変更します
2. references/analysis-framework.md に従ってコンテンツを分析します
3. コンテンツの特徴を分析し、スタイルを推奨します
4. ソース言語を検出します
5. 推奨スライド枚数を決定します
6. コンテンツからトピックのスラッグを生成します

1.3 既存のコンテンツを確認する ⚠️ 必須

ステップ 2 に進む前に、必ず実行してください。

Bash を使って出力ディレクトリが存在するか確認します。

test -d "slide-deck/{topic-slug}" && echo "exists"

ディレクトリが存在する場合は、AskUserQuestion を使います。

header: "Existing"
question: "Existing content found. How to proceed?"
options:
  - label: "Regenerate outline"
    description: "Keep images, regenerate outline only"
  - label: "Regenerate images"
    description: "Keep outline, regenerate images only"
  - label: "Backup and regenerate"
    description: "Backup to {slug}-backup-{timestamp}, then regenerate all"
  - label: "Exit"
    description: "Cancel, keep existing content unchanged"

以下を含めて analysis.md に保存します。

• トピック、対象読者、コンテンツの特徴
• 推奨スタイル（自動スタイル選択に基づく）
• 推奨スライド枚数
• 言語の検出結果

ステップ 2：確認 ⚠️ 必須

2 ラウンドの確認：ラウンド 1 は必ず実施し、「カスタム寸法」が選択された場合のみラウンド 2 を実施します。

言語：ユーザーの入力言語、または保存済みの言語設定を使用します。

概要を表示します。

• 特定したコンテンツの種類とトピック
• 言語：［EXTEND.md から取得、または検出］
• 推奨スタイル：［プリセット］（コンテンツの特徴に基づく）
• 推奨スライド枚数：［N］（コンテンツの長さに基づく）

ラウンド 1（必ず実施）

5 つの質問すべてに AskUserQuestion を使います。

質問 1：スタイル

header: "Style"
question: "Which visual style for this deck?"
options:
  - label: "{recommended_preset} (Recommended)"
    description: "Best match based on content analysis"
  - label: "{alternative_preset}"
    description: "[alternative style description]"
  - label: "Custom dimensions"
    description: "Choose texture, mood, typography, density separately"

質問 2：対象読者

header: "Audience"
question: "Who is the primary reader?"
options:
  - label: "General readers (Recommended)"
    description: "Broad appeal, accessible content"
  - label: "Beginners/learners"
    description: "Educational focus, clear explanations"
  - label: "Experts/professionals"
    description: "Technical depth, domain knowledge"
  - label: "Executives"
    description: "High-level insights, minimal detail"

質問 3：スライド枚数

header: "Slides"
question: "How many slides?"
options:
  - label: "{N} slides (Recommended)"
    description: "Based on content length"
  - label: "Fewer ({N-3} slides)"
    description: "More condensed, less detail"
  - label: "More ({N+3} slides)"
    description: "More detailed breakdown"

質問 4：アウトラインのレビュー

header: "Outline"
question: "Review outline before generating prompts?"
options:
  - label: "Yes, review outline (Recommended)"
    description: "Review slide titles and structure"
  - label: "No, skip outline review"
    description: "Proceed directly to prompt generation"

質問 5：プロンプトのレビュー

header: "Prompts"
question: "Review prompts before generating images?"
options:
  - label: "Yes, review prompts (Recommended)"
    description: "Review image generation prompts"
  - label: "No, skip prompt review"
    description: "Proceed directly to image generation"

ラウンド 2（「カスタム寸法」が選択された場合のみ）

4 つの寸法すべてについて AskUserQuestion を使います。

質問 1：テクスチャ

header: "Texture"
question: "Which visual texture?"
options:
  - label: "clean"
    description: "Pure solid color, no texture"
  - label: "grid"
    description: "Subtle grid overlay, technical"
  - label: "organic"
    description: "Soft textures, hand-drawn feel"
  - label: "pixel"
    description: "Chunky pixels, 8-bit aesthetic"

（注：「paper」は「Other」から選択できます）

質問 2：雰囲気

header: "Mood"
question: "Which color mood?"
options:
  - label: "professional"
    description: "Cool-neutral, navy/gold"
  - label: "warm"
    description: "Earth tones, friendly"
  - label: "cool"
    description: "Blues, grays, analytical"
  - label: "vibrant"
    description: "High saturation, bold"

（注：「dark」と「neutral」は「Other」から選択できます）

質問 3：タイポグラフィ

header: "Typography"
question: "Which typography style?"
options:
  - label: "geometric"
    description: "Modern sans-serif, clean"
  - label: "humanist"
    description: "Friendly, readable"
  - label: "handwritten"
    description: "Marker/brush, organic"
  - label: "editorial"
    description: "Magazine style, dramatic"

（注：「technical」は「Other」から選択できます）

質問 4：密度

header: "Density"
question: "Information density?"
options:
  - label: "balanced (Recommended)"
    description: "2-3 key points per slide"
  - label: "minimal"
    description: "One focus point, maximum whitespace"
  - label: "dense"
    description: "Multiple data points, compact"

ラウンド 2 の後：カスタム寸法をスタイル設定として保存します。

確認後：

1. 確認済みの設定で analysis.md を更新します
2. 質問 4 の skip_outline_review フラグを保存します
3. 質問 5 の skip_prompt_review フラグを保存します
4. → ステップ 3

ステップ 3：アウトラインを生成する

ステップ 2 で確認したスタイルを使って、アウトラインを作成します。

スタイルの解決：

• プリセットが選択された場合 → references/styles/{preset}.md を読み込みます
• カスタム寸法が選択された場合 → references/dimensions/ から寸法ファイルを読み込み、組み合わせます

生成：

1. 構成については references/outline-template.md に従います
2. スタイルまたは寸法から STYLE_INSTRUCTIONS を作成します
3. 確認済みの対象読者、言語、スライド枚数を適用します
4. outline.md として保存します

生成後：

• --outline-only が指定されている場合は、ここで停止します
• skip_outline_review が true の場合は、ステップ 4 をスキップしてステップ 5 に進みます
• skip_outline_review が false の場合は、ステップ 4 に進みます

ステップ 4：アウトラインを確認する（条件付き）

ステップ 2 で「いいえ。アウトラインの確認をスキップ」を選択した場合は、このステップをスキップします。

目的：プロンプトを生成する前に、アウトラインの構成を確認します。

言語：ユーザーの入力言語または保存された言語設定を使用します。

表示：

• スライドの合計数：N
• スタイル：[プリセット名または「カスタム：テクスチャ＋ムード＋タイポグラフィ＋密度」]
• スライドごとの概要表：

| # | Title | Type | Layout |
|---|-------|------|--------|
| 1 | [title] | Cover | title-hero |
| 2 | [title] | Content | [layout] |
| 3 | [title] | Content | [layout] |
| ... | ... | ... | ... |

AskUserQuestion を使用：

header: "Confirm"
question: "Ready to generate prompts?"
options:
  - label: "Yes, proceed (Recommended)"
    description: "Generate image prompts"
  - label: "Edit outline first"
    description: "I'll modify outline.md before continuing"
  - label: "Regenerate outline"
    description: "Create new outline with different approach"

回答後：

1. 「先にアウトラインを編集」を選択した場合 → outline.md を編集するようユーザーに伝え、準備ができたら再度確認します
2. 「アウトラインを再生成」を選択した場合 → ステップ 3 に戻ります
3. 「はい、続行」を選択した場合 → ステップ 5 に進みます

ステップ 5：プロンプトを生成する

1. references/base-prompt.md を読み込みます
2. アウトライン内の各スライドについて：
   • アウトラインから STYLE_INSTRUCTIONS を抽出します（スタイルファイルから再度取得しません）
   • スライド固有のコンテンツを追加します
   • Layout: が指定されている場合は、references/layouts.md のレイアウトガイダンスを含めます
3. prompts/ ディレクトリに保存します
   • バックアップルール：プロンプトファイルが存在する場合は、prompts/NN-slide-{slug}-backup-YYYYMMDD-HHMMSS.md に名前を変更します

生成後：

• --prompts-only の場合は、ここで停止してプロンプトの概要を出力します
• skip_prompt_review が true の場合は → ステップ 6 をスキップし、ステップ 7 に進みます
• skip_prompt_review が false の場合は → ステップ 6 に進みます

ステップ 6：プロンプトを確認する（条件付き）

ステップ 2 で「いいえ。プロンプトの確認をスキップ」を選択した場合は、このステップをスキップします。

目的：画像を生成する前に、プロンプトを確認します。

言語：ユーザーの入力言語または保存された言語設定を使用します。

表示：

• プロンプトの合計数：N
• スタイル：[プリセット名またはカスタムの各要素]
• プロンプト一覧：

| # | Filename | Slide Title |
|---|----------|-------------|
| 1 | 01-slide-cover.md | [title] |
| 2 | 02-slide-xxx.md | [title] |
| ... | ... | ... |

• プロンプトディレクトリのパス：prompts/

AskUserQuestion を使用：

header: "Confirm"
question: "Ready to generate slide images?"
options:
  - label: "Yes, proceed (Recommended)"
    description: "Generate all slide images"
  - label: "Edit prompts first"
    description: "I'll modify prompts before continuing"
  - label: "Regenerate prompts"
    description: "Create new prompts with different approach"

回答後：

1. 「先にプロンプトを編集」を選択した場合 → プロンプトを編集するようユーザーに伝え、準備ができたら再度確認します
2. 「プロンプトを再生成」を選択した場合 → ステップ 5 に戻ります
3. 「はい、続行」を選択した場合 → ステップ 7 に進みます

ステップ 7：画像を生成する

--images-only の場合：既存のプロンプトを使用して、ここから開始します。

--regenerate N の場合：指定されたスライドのみを再生成します。

標準フロー：

1. 利用可能な画像生成スキルを選択します
2. セッション ID を生成します：slides-{topic-slug}-{timestamp}
3. 各スライドについて：
   • バックアップルール：画像ファイルが存在する場合は、NN-slide-{slug}-backup-YYYYMMDD-HHMMSS.png に名前を変更します
   • 同じセッション ID を使用して、順番に画像を生成します
4. 進捗を報告します：「X/N を生成しました」（ユーザーの言語で）
5. エラーを報告する前に、失敗時は 1 回自動で再試行します

ステップ 8：PPTX と PDF にまとめる

npx -y bun ${SKILL_DIR}/scripts/merge-to-pptx.ts <slide-deck-dir>
npx -y bun ${SKILL_DIR}/scripts/merge-to-pdf.ts <slide-deck-dir>

ステップ 9：概要を出力する

言語：ユーザーの入力言語または保存された言語設定を使用します。

Slide Deck Complete!

Topic: [topic]
Style: [preset name or custom dimensions]
Location: [directory path]
Slides: N total

- 01-slide-cover.png - Cover
- 02-slide-intro.png - Content
- ...
- {NN}-slide-back-cover.png - Back Cover

Outline: outline.md
PPTX: {topic-slug}.pptx
PDF: {topic-slug}.pdf

部分的なワークフロー

オプション	ワークフロー
--outline-only	ステップ 1〜3 のみ（アウトライン作成後に停止）
--prompts-only	ステップ 1〜5（プロンプトを生成し、画像生成をスキップ）
--images-only	ステップ 7 に進む（既存の prompts/ が必要）
--regenerate N	指定したスライドのみを再生成

--prompts-only の使用

画像を生成せずに、アウトラインとプロンプトを生成します：

/canghe-slide-deck content.md --prompts-only

出力：確認・編集できる状態の outline.md と prompts/*.md。

--images-only の使用

既存のプロンプトから画像を生成します（ステップ 7 から開始）：

/canghe-slide-deck slide-deck/topic-slug/ --images-only

前提条件：

• スライドのプロンプトファイルを含む prompts/ ディレクトリ
• スタイル情報を含む outline.md

--regenerate の使用

指定したスライドを再生成します：

# Single slide
/canghe-slide-deck slide-deck/topic-slug/ --regenerate 3

# Multiple slides
/canghe-slide-deck slide-deck/topic-slug/ --regenerate 2,5,8

フロー：

1. 指定したスライドの既存プロンプトを読み込みます
2. それらのスライドの画像のみを再生成します
3. PPTX と PDF を再生成します

スライドの変更

クイックリファレンス

操作	コマンド	手動での手順
編集	--regenerate N	最初にプロンプトファイルを更新 → 画像を再生成 → PDF を再生成
追加	手動	プロンプトを作成 → 画像を生成 → 後続のスライドを振り直す → アウトラインを更新 → PDF を再生成
削除	手動	ファイルを削除 → 後続のスライドを振り直す → アウトラインを更新 → PDF を再生成

単一スライドの編集

1. まずプロンプトファイルを更新します: prompts/NN-slide-{slug}.md
2. 実行: /canghe-slide-deck <dir> --regenerate N
3. または手動で画像 + PDF を再生成します

IMPORTANT: スライドを更新する際は、再生成する前に必ず最初にプロンプトファイル (prompts/NN-slide-{slug}.md) を更新してください。これにより、変更が文書化され再現可能になります。

新しいスライドの追加

1. 指定位置にプロンプトを作成します: prompts/NN-slide-{new-slug}.md
2. 同じセッション ID を使用して画像を生成します
3. 再採番: 後続のファイルは NN+1 (スラッグは変更なし)
4. outline.md を更新します
5. PPTX/PDF を再生成します

スライドの削除

1. NN-slide-{slug}.png と prompts/NN-slide-{slug}.md を削除します
2. 再採番: 後続のファイルは NN-1 (スラッグは変更なし)
3. outline.md を更新します
4. PPTX/PDF を再生成します

ファイル命名

形式: NN-slide-[slug].png

• NN: 2 桁の連番 (01, 02, ...)
• slug: コンテンツに基づくケバブケース (2〜5 語、一意)

再採番のルール: NN のみが変更され、スラッグは変更されません。

完全な詳細については references/modification-guide.md を参照してください。

リファレンス

ファイル	内容
references/analysis-framework.md	プレゼンテーションのコンテンツ分析
references/outline-template.md	アウトラインの構造と形式
references/modification-guide.md	スライドの編集、追加、削除のワークフロー
references/content-rules.md	コンテンツとスタイルのガイドライン
references/design-guidelines.md	オーディエンス、タイポグラフィ、配色、視覚要素
references/layouts.md	レイアウトの選択肢と選択のヒント
references/base-prompt.md	画像生成用のベースプロンプト
references/dimensions/*.md	ディメンション仕様 (テクスチャ、ムード、タイポグラフィ、密度)
references/dimensions/presets.md	プリセット → ディメンションのマッピング
references/styles/<style>.md	完全なスタイル仕様 (レガシー)
references/config/preferences-schema.md	EXTEND.md の構造

注意事項

• 画像生成: スライドあたり 10〜30 秒
• 生成失敗時は自動で 1 回再試行します
• 敏感な公人の場合はスタイライズされた代替を使用してください
• セッション ID を通じてスタイルの一貫性を維持します
• ステップ 2 の確認が必須 - 省略しないでください (スタイル、オーディエンス、スライド、アウトラインのレビュー、プロンプトのレビュー)
• ステップ 4 は条件付き - ユーザーがステップ 2 でアウトラインのレビューを要求した場合のみ
• ステップ 6 は条件付き - ユーザーがステップ 2 でプロンプトのレビューを要求した場合のみ

拡張サポート

EXTEND.md によるカスタム設定。パスとサポートされるオプションについては ステップ 1.1 を参照してください。