marp-creator

name	marp-creator
description	Marpでスライド資料を作成するスキル。メモの整理、スライド設計、Marpファイル生成の3ステップで資料を作成する。提案書や勉強会資料の作成時に使用する。

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の出力（最終成果物）

反復的な改善

初回作成後、以下のサイクルで品質を高める。

1. スライド設計書を確認し、構成の過不足をチェック
2. 必要に応じて整理済みmdを修正
3. 再度スライド設計書を生成
4. 問題なければMarp資料を生成

トラブルシューティング

スライド枚数が多すぎる:

• 内容を絞り込む（整理済みmdを修正）
• 複数のスライドを統合する（設計書で調整）

情報が1スライドに収まらない:

• スライドを分割する
• 箇条書きを簡潔にする
• small-textレイアウトを検討（最終手段）

レイアウトが思い通りにならない:

• 最新のサンプルスライドを取得して確認（get-sample-slide.md）
• _class のコメント記法が正しいか確認