classmethod Marp Creator
Marpで提案書や勉強会資料を作成する。内容整理とスライド化を分離し、段階的に進めることで質の高い資料を作成する。
ワークフロー
3つのステップで資料を作成する。各ステップの完了後は必ずユーザー確認を行い、承認を得てから次のステップに進む。
メモ・要件（任意の形式・ファイル名）
↓
[ステップ1] 内容整理 → 01_organized_*.md
↓
※ ユーザー確認（内容の過不足、構成の修正）
↓
[ステップ2] スライド設計 → 02_slide-design_*.md
↓
※ ユーザー確認（スライド構成、レイアウト、枚数）
↓
[ステップ3] Marp資料作成 → 03_marp_*.md（最終成果物）
重要: 1ステップずつ実行し、ユーザーの明示的な承認なしに次のステップへ自動で進んではならない。ディレクトリやファイルを渡されても、必ず1ステップ完了ごとに確認を求める。
開始ステップの判断
入力ファイルの種類に応じて、開始するステップを自動判断する。
| 入力ファイル | 開始ステップ |
|---|---|
| メモ・要件（接頭辞なし） | ステップ1から開始 |
01_organized_*.md |
ステップ2から開始 |
02_slide-design_*.md |
ステップ3から開始 |
途中から再開する場合は、該当する接頭辞のファイルを入力として渡す。
ステップ1: 内容整理
メモや箇条書きを構造化されたMarkdownに整理する。Marpの記法やスライド枚数は意識せず、伝えたい内容の構造化に集中する。
入力: メモファイル、資料の目的、対象者
出力: 01_organized_[資料名].md
詳細な手順は organize-content.md を参照。
完了時の確認事項:
- 伝えたい内容が漏れなく整理されているか
- 構成の順序は適切か
- 不要な情報が含まれていないか
ユーザーが内容を確認し、修正指示がなければ次のステップへ進む。
ステップ2: スライド設計
整理した内容をスライドに分割し、各スライドの構成を定義する。レイアウトや情報量を調整する中間成果物を作成する。
入力: 01_organized_[資料名].md、発表時間（任意）
出力: 02_slide-design_[資料名].md
発表時間とスライド枚数の目安:
- 5分: 5〜8枚
- 10分: 10〜15枚
- 15分: 15〜20枚
- 30分: 20〜30枚
詳細な手順は slide-design.md を参照。
完了時の確認事項:
- スライド枚数は発表時間に対して適切か
- 各スライドのレイアウトは内容に合っているか
- 情報量のバランスは取れているか
ユーザーが構成を確認し、修正指示がなければ次のステップへ進む。
ステップ3: Marp資料作成
スライド設計書に基づき、Marp形式の最終資料を生成する。
入力: 02_slide-design_[資料名].md
出力: 03_marp_[資料名].md（最終成果物）
詳細な手順は build-marp.md を参照。
レイアウトクラス一覧
| レイアウトクラス | 用途 |
|---|---|
| title | 表紙 |
| section | セクション区切り |
| （指定なし）基本 | テキスト中心、箇条書きが主体 |
| image | 図表のみを大きく表示 |
| content-image | 図表とキャプション |
| content-image-right | 文章と図表を横並び（図が右） |
| content-image-left | 文章と図表を横並び（図が左） |
| column-layout | 複数項目を横並び |
| small-text | 情報量が多い場合の文字縮小 |
テンプレートとサンプルの取得方法は get-sample-slide.md を参照。
ファイル命名規則
| 接頭辞 | 説明 |
|---|---|
| 01_organized_ | ステップ1の出力（整理済み） |
| 02_slide-design_ | ステップ2の出力（設計書） |
| 03_marp_ | ステップ3の出力（最終成果物） |
反復的な改善
初回作成後、以下のサイクルで品質を高める。
- スライド設計書を確認し、構成の過不足をチェック
- 必要に応じて整理済みmdを修正
- 再度スライド設計書を生成
- 問題なければMarp資料を生成
トラブルシューティング
スライド枚数が多すぎる:
- 内容を絞り込む（整理済みmdを修正）
- 複数のスライドを統合する（設計書で調整）
情報が1スライドに収まらない:
- スライドを分割する
- 箇条書きを簡潔にする
- small-textレイアウトを検討（最終手段）
レイアウトが思い通りにならない:
- 最新のサンプルスライドを取得して確認（get-sample-slide.md）
_classのコメント記法が正しいか確認