Skip to main content Link Menu Expand (external link) Document Search Copy Copied
AutoSlideIdea Documentation

基本的なワークフロー

基本的なワークフロー

💡 参考: サンプルプレゼンテーションで実際の出力例を確認

1. プレゼンテーションの作成・管理

🎯 推奨：統合管理スクリプト

# 自動判定モード（新規なら作成、既存なら適切な提案）
./scripts/manage-presentation.sh my-presentation

# GitHubリポジトリとして作成・更新
./scripts/manage-presentation.sh --github conference-2024

# フルプロジェクト（調査・分析含む）
./scripts/manage-presentation.sh --full research-project

# テンプレート指定
./scripts/manage-presentation.sh --template academic conference-talk

# 明示的モード
./scripts/manage-presentation.sh --create my-new-presentation   # 新規作成のみ
./scripts/manage-presentation.sh --update existing-project     # 更新のみ

📝 従来方式（非推奨）

# 自動的に manage-presentation.sh に転送されます
./scripts/create-presentation.sh my-presentation
./scripts/update-presentation.sh --add-github my-presentation

重要: presentations/ディレクトリは.gitignoreされているため、作成したプレゼンテーションはAutoSlideIdeaリポジトリにはプッシュされません。

プレゼンテーションの管理方法

  1. ローカル作業のまま: 機密性が高い場合はそのまま作業
  2. 個別リポジトリ化: 共有やGitHub Actions連携が必要な場合
# GitHubリポジトリとして作成（推奨）
./scripts/create-presentation.sh --github my-presentation

# パブリックリポジトリとして作成
./scripts/create-presentation.sh --github --public my-presentation

# GitHub Pages専用ワークフローで作成
./scripts/create-presentation.sh --github --workflow github-pages my-presentation

フルプロジェクトの構造 

research-project/
├── research/              # 調査フェーズ
│   ├── data/             # 生データ
│   ├── analysis/         # 分析結果
│   └── notes.md          # 調査メモ
├── ideation/             # アイデア創出
│   ├── brainstorm.md     # ブレインストーミング
│   └── drafts/           # 構成案
├── assets/               # リソース
└── slides.md             # 最終スライド

2. AI支援による構成作成

AIツールでの例（Claude Code、Gemini CLIなど） 

プロンプト例：
"技術カンファレンス向けに「AIとソフトウェア開発の未来」というテーマで
15分のプレゼンテーション構成を作成してください。
対象者は経験豊富な開発者です。"

期待される出力 

1. タイトル＆自己紹介（1分）
2. 現状の課題（2分）
3. AIツールの進化（3分）
4. 実践例とデモ（5分）
5. 将来の展望（3分）
6. まとめ＆Q&A（1分）

3. コンテンツの作成

段階的なアプローチ

  1. 骨子の作成 
    # AIに構成を元に各スライドの骨子を作成してもらう
"presentations/my-presentation/slides.md の各セクションに
箇条書きでポイントを追加してください"
  2. 詳細の追加 
    # 特定のスライドを深掘り
"スライド4の実践例について、具体的なコード例と
ビフォーアフターの比較を追加してください"
  3. ビジュアルの追加 
    # 図表やグラフの追加
"スライド3にAIツールの進化を示すタイムラインを
Mermaidで作成してください"

4. レビューと改善

セルフレビューのチェックリスト

  • 時間配分は適切か？
  • メッセージは明確か？
  • 技術的な正確性は保たれているか？
  • ビジュアルは効果的か？
  • フローは論理的か？

AI支援による改善 

# 全体的なレビュー
"このプレゼンテーションを見直して、
改善点を5つ提案してください"

# 特定の観点でのレビュー
"技術的な正確性の観点から、
修正が必要な箇所を指摘してください"

5. ビルドと配布

Mermaid図表の前処理（図表を含む場合）

Mermaidコードブロックを含む場合は、ビルド前に前処理が必要です：

# 単一ファイルの処理
./scripts/preprocess-mermaid.sh presentations/my-presentation/slides.md

# 処理済みファイルでビルド
npm run pdf -- presentations/my-presentation/slides-processed.md \
  -o presentations/my-presentation/output.pdf \
  --theme ../config/marp/base.css

# または一括処理
./scripts/batch-preprocess-mermaid.sh \
  -o presentations/my-presentation/processed \
  presentations/my-presentation/*.md

詳細はMermaid統合ガイドを参照してください。

ローカルでのビルド 

# PDF生成
npm run pdf -- presentations/my-presentation/slides.md \
  -o presentations/my-presentation/output.pdf \
  --theme ../config/marp/base.css

# HTML生成（プレゼンモード）
npm run html -- presentations/my-presentation/slides.md \
  -o presentations/my-presentation/index.html \
  --theme ../config/marp/base.css

# プレビューモード
npm run preview -- presentations/my-presentation/slides.md

GitHub Actionsでの自動ビルド 

# プッシュ時に自動的にPDFを生成
on:
  push:
    branches: [main]
    paths:
      - 'presentations/**/*.md'

6. 統合管理スクリプトの詳細機能

manage-presentation.shは自動判定で適切な処理を行いますが、明示的なオプションも利用できます。

自動判定の動作 

# 既存チェック → 新規作成または更新提案
./scripts/manage-presentation.sh my-presentation

# GitHub連携（新規なら作成、既存なら追加）
./scripts/manage-presentation.sh --github existing-or-new-presentation

明示的な操作 

# 強制作成モード（既存の場合はエラー）
./scripts/manage-presentation.sh --create new-presentation

# 強制更新モード（存在しない場合はエラー）
./scripts/manage-presentation.sh --update existing-presentation --workflow github-pages

# 構造の拡張
./scripts/manage-presentation.sh --add-assets --add-research my-presentation

従来スクリプトとの互換性 

# 以下は自動的に manage-presentation.sh に転送されます
./scripts/update-presentation.sh --add-github my-presentation
# ↓ 実際の実行
./scripts/manage-presentation.sh --update --add-github my-presentation

高度なワークフロー

マルチ言語対応 

# 日本語版から英語版を生成
"presentations/my-presentation/slides.md を英語に翻訳して
presentations/my-presentation/slides-en.md として保存してください。
技術用語は適切に保ってください。"

データ駆動型スライド 

# データからグラフを生成するスクリプト
import matplotlib.pyplot as plt
import pandas as pd

# データ読み込み
data = pd.read_csv('data.csv')

# グラフ生成
plt.figure(figsize=(10, 6))
plt.plot(data['date'], data['value'])
plt.savefig('presentations/my-presentation/images/graph.png')

チーム協業 

# ブランチ戦略
git checkout -b feature/conference-presentation
# 作業...
git add .
git commit -m "Add conference presentation draft"
git push origin feature/conference-presentation
# Pull Requestを作成

ベストプラクティス

1. インクリメンタルな作成

  • 一度にすべてを完成させない
  • 小さなセクションごとに作成・レビュー
  • 頻繁にプレビューで確認

2. バージョン管理の活用 

# 意味のあるコミットメッセージ
git commit -m "Add performance comparison data to slide 5"

# タグ付けで重要なバージョンを記録
git tag -a v1.0 -m "Conference presentation version"

3. AI利用のコツ

  • 具体的な指示: 曖昧な指示より具体的な要求
  • 段階的な改善: 一度に完璧を求めない
  • コンテキストの提供: 背景情報を十分に与える

4. 再利用性の向上 

# 共通パーツをテンプレート化
mkdir -p templates/components
echo "# 会社紹介スライド" > templates/components/company-intro.md

# インクルード機能の活用（Marpでは直接サポートされないため、スクリプトで対応）
./scripts/build-with-includes.sh

トラブルシューティング

よくある問題と解決策

  1. スライドが長すぎる
    • AI支援で要約: “このスライドを3つの要点に要約してください”
    • 補足資料として別スライドに移動
  2. 技術的な説明が複雑
    • 段階的な説明に分割
    • ビジュアルで補完
  3. 時間内に収まらない
    • 優先度を設定
    • デモを録画に変更