// Marpでスライド資料を作成するスキル。メモの整理、スライド設計、Marpファイル生成の3ステップで資料を作成する。提案書や勉強会資料の作成時に使用する。
| name | marp-creator |
| description | Marpでスライド資料を作成するスキル。メモの整理、スライド設計、Marpファイル生成の3ステップで資料を作成する。提案書や勉強会資料の作成時に使用する。 |
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から開始 |
途中から再開する場合は、該当する接頭辞のファイルを入力として渡す。
メモや箇条書きを構造化されたMarkdownに整理する。Marpの記法やスライド枚数は意識せず、伝えたい内容の構造化に集中する。
入力: メモファイル、資料の目的、対象者
出力: 01_organized_[資料名].md
詳細な手順は organize-content.md を参照。
完了時の確認事項:
ユーザーが内容を確認し、修正指示がなければ次のステップへ進む。
整理した内容をスライドに分割し、各スライドの構成を定義する。レイアウトや情報量を調整する中間成果物を作成する。
入力: 01_organized_[資料名].md、発表時間（任意）
出力: 02_slide-design_[資料名].md
発表時間とスライド枚数の目安:
詳細な手順は slide-design.md を参照。
完了時の確認事項:
ユーザーが構成を確認し、修正指示がなければ次のステップへ進む。
スライド設計書に基づき、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の出力（最終成果物） |
初回作成後、以下のサイクルで品質を高める。
スライド枚数が多すぎる:
情報が1スライドに収まらない:
レイアウトが思い通りにならない:
_class のコメント記法が正しいか確認