diff --git a/.claude/skills/marp-creator/SKILL.md b/.claude/skills/marp-creator/SKILL.md new file mode 100644 index 0000000..c4f59b5 --- /dev/null +++ b/.claude/skills/marp-creator/SKILL.md @@ -0,0 +1,115 @@ +--- +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から開始 | +| `01_organized_*.md` | ステップ2から開始 | +| `02_slide-design_*.md` | ステップ3から開始 | + +各ステップは1つずつ実行し、出力後に次のステップへ進むか確認する。途中から再開する場合は、該当する接頭辞のファイルを入力として渡す。 + +## ステップ1: 内容整理 + +メモや箇条書きを構造化されたMarkdownに整理する。Marpの記法やスライド枚数は意識せず、伝えたい内容の構造化に集中する。 + +**入力:** メモファイル、資料の目的、対象者 +**出力:** `01_organized_[資料名].md` + +詳細な手順は [organize-content.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](slide-design.md) を参照。 + +## ステップ3: Marp資料作成 + +スライド設計書に基づき、Marp形式の最終資料を生成する。 + +**入力:** `02_slide-design_[資料名].md` +**出力:** `03_marp_[資料名].md`(最終成果物) + +詳細な手順は [build-marp.md](build-marp.md) を参照。 + +## レイアウトクラス一覧 + +| レイアウトクラス | 用途 | +|-----------------|------| +| title | 表紙 | +| section | セクション区切り | +| (指定なし)基本 | テキスト中心、箇条書きが主体 | +| image | 図表のみを大きく表示 | +| content-image | 図表とキャプション | +| content-image-right | 文章と図表を横並び(図が右) | +| content-image-left | 文章と図表を横並び(図が左) | +| column-layout | 複数項目を横並び | +| small-text | 情報量が多い場合の文字縮小 | + +テンプレートとサンプルの取得方法は [get-sample-slide.md](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](get-sample-slide.md)) +- `_class` のコメント記法が正しいか確認 diff --git a/.claude/skills/marp-creator/build-marp.md b/.claude/skills/marp-creator/build-marp.md new file mode 100644 index 0000000..d05c5d2 --- /dev/null +++ b/.claude/skills/marp-creator/build-marp.md @@ -0,0 +1,414 @@ +# Marp資料作成(ステップ3) + +スライド設計書(slide-designの出力)から、Marp形式のスライド資料を生成する。このスキルの出力が最終成果物となる。 + +## 入力 + +ユーザーから以下の情報を受け取る。 + +| 項目 | 説明 | 形式 | +|------|------|------| +| スライド設計書 | slide-designの出力 | `02_slide-design_[資料名].md` | +| 画像ファイル | 使用する画像(任意) | パスまたは配置予定の説明 | + +出力先は入力ファイルと同じフォルダに配置する。 + +## 出力 + +`03_marp_[資料名].md` を生成する。 + +### ファイル構造 + +```markdown +--- +marp: true +theme: classmethod +paginate: true +title: [資料タイトル] +description: [資料の説明] +--- + + + + +![classmethod-logo w:400px](https://classmethod.jp/wp-content/themes/cmn/assets/images/common/logo_classmethod.svg) + +# [資料タイトル] + +[日付や執筆者情報] + +--- + + + + +## [セクション名] +[セクションの説明文] + +--- + +# [スライドタイトル] + +[本文や箇条書き] + +--- + +[以下、全スライドを記載] +``` + +## ワークフロー + +### Step 1: スライド設計書の読み込み + +`02_slide-design_[資料名].md` を読み込み、以下を把握する。 + +- 資料タイトルと説明 +- スライド枚数と各スライドの構成 +- 使用するレイアウトクラス +- 図表の配置位置 + +### Step 2: サンプルスライドの取得 + +以下のコマンドで最新のサンプルスライドを取得する。 + +```bash +curl -s https://raw.githubusercontent.com/classmethod/classmethod-marp-theme/main/sample-slide.md +``` + +取得したサンプルから以下を確認する。 + +- Front matter の記述方法 +- 各レイアウトクラスの使用例 +- 画像配置の記法 +- コメント記法(``) + +詳細は [get-sample-slide.md](get-sample-slide.md) を参照。 + +### Step 3: Front matter の作成 + +ファイル冒頭のメタデータを作成する。 + +```yaml +--- +marp: true +theme: classmethod +paginate: true +title: [資料タイトル] +description: [資料の説明(1〜2文)] +--- +``` + +### Step 4: 表紙スライドの作成 + +表紙(titleレイアウト)を作成する。 + +```markdown + + + +![classmethod-logo w:400px](https://classmethod.jp/wp-content/themes/cmn/assets/images/common/logo_classmethod.svg) + +# [資料タイトル] + +[日付や執筆者情報] + +--- +``` + +**注意点:** +- `_class` の前にアンダースコアを付ける +- ページネーションは false に設定 +- ロゴのURLは固定値を使用 + +### Step 5: 各スライドの生成 + +スライド設計書に基づき、各スライドを生成する。 + +**基本的なスライド記法:** + +```markdown +--- + +# [スライドタイトル] + +[本文や箇条書き] + +--- +``` + +**セクションスライドの記法:** + +```markdown +--- + + + + +## [セクション名] +[説明文] + +--- +``` + +**図表を含むスライド(content-image):** + +```markdown +--- + + + +# [スライドタイトル] + +![w:700px]([画像パスまたはプレースホルダー]) + +[キャプションや説明文] + +--- +``` + +**横並びレイアウト(content-image-right):** + +```markdown +--- + + + +# [スライドタイトル] + +![w:500px]([画像パス]) + +- [ポイント1] +- [ポイント2] +- [ポイント3] + +--- +``` + +**カラムレイアウト(column-layout):** + +```markdown +--- + + + +# [スライドタイトル] + +
+ +## [左カラム] +- [項目1] +- [項目2] + +
+ +
+ +## [右カラム] +- [項目1] +- [項目2] + +
+ +--- +``` + +### Step 6: レイアウトクラスの適用 + +スライド設計書で指定されたレイアウトクラスを正確に適用する。 + +| レイアウトクラス | コメント記法 | ページネーション | +|-----------------|-------------|-----------------| +| title | `` | false | +| section | `` | false | +| 基本(指定なし) | コメント不要 | true(デフォルト) | +| image | `` | true | +| content-image | `` | true | +| content-image-right | `` | true | +| content-image-left | `` | true | +| column-layout | `` | true | +| small-text | `` | true | +| no-header | `` | true | + +**幅調整が必要な場合:** +- content-image-right/left では、`content-60` などのクラスを追加して幅を調整できる +- 例: `` + +### Step 7: 画像の配置 + +図表が必要な箇所に画像を配置する。 + +**画像記法:** +```markdown +![w:700px](images/diagram.png) +``` + +**サイズ指定:** +- `w:XXpx`: 幅を指定(例: w:400px, w:700px) +- `h:XXpx`: 高さを指定(例: h:300px) + +**画像が未準備の場合:** +プレースホルダーを使用する。 + +```markdown +![w:700px](https://placehold.jp/300x200.png) + +``` + +または、コメントのみを記載する。 + +```markdown + +``` + +### Step 8: 箇条書きと強調の適用 + +スライド設計書の内容を、適切に箇条書きや強調で表現する。 + +**箇条書き:** +```markdown +- 項目1 +- 項目2 +- 項目3 +``` + +**番号付きリスト:** +```markdown +1. ステップ1 +2. ステップ2 +3. ステップ3 +``` + +**強調(見出しの一部を青色にする):** +```markdown +## 見出しの一部を**青色のアクセントカラー**にする +``` + +見出し内の `**` で囲まれた部分は青色のアクセントカラーになる。 + +### Step 9: 参考リンクの配置 + +スライド設計書に「参考リンク」がある場合、スライド末尾に配置する。 + +**参考リンクの記法:** +```markdown +参考: [リンクタイトル](URL) +``` + +リンクはスライドの本文の最後に配置し、「参考:」のラベルを付ける。 + +### Step 10: ページネーションの制御 + +適切にページネーションを制御する。 + +- 表紙(title): `` +- セクション(section): `` +- その他: デフォルト(true)のまま + +### Step 11: ファイル出力 + +`03_marp_[資料名].md` を出力する。 + +ファイル作成後、以下をユーザーに伝える。 + +- 出力ファイルのパス +- スライド枚数 +- 次のアクション(プレビュー、PDF変換など) +- 画像が未配置の場合はその旨 + +## Marp記法リファレンス + +### Front matter + +```yaml +--- +marp: true +theme: classmethod +paginate: true +title: スライドタイトル +description: スライドの説明 +--- +``` + +### スライド区切り + +```markdown +--- +``` + +3つのハイフンで区切る。 + +### レイアウトクラス指定 + +```markdown + +``` + +コメント形式で指定。`_class` の前にアンダースコアを付ける。 + +### ページネーション制御 + +```markdown + +``` + +個別スライドでページ番号を非表示にする。 + +### 画像サイズ指定 + +```markdown +![w:400px](path/to/image.png) +![h:300px](path/to/image.png) +``` + +### 見出し強調 + +```markdown +## 見出しの一部を**青色**にする +``` + +見出し内の `**` 囲みは青色のアクセントカラーになる。 + +### コードブロック + +````markdown +```typescript +const message: string = "Hello, Marp!"; +console.log(message); +``` +```` + +### 引用 + +```markdown +> 引用文 +``` + +### テーブル + +```markdown +| 列1 | 列2 | 列3 | +|-----|-----|-----| +| A | B | C | +``` + +### カスタムCSS(スライド固有) + +```markdown + + +
+強調したいコンテンツ +
+``` + +## エラー対処 + +| エラー | 原因 | 対処 | +|--------|------|------| +| スライド設計書が読めない | パスが間違っている | ユーザーに正しいパスを確認 | +| レイアウトが正しく表示されない | クラス名が間違っている | 最新のサンプルスライドを取得して確認 | +| 画像が表示されない | パスが間違っている | 画像ファイルの配置を確認 | diff --git a/.claude/skills/marp-creator/get-sample-slide.md b/.claude/skills/marp-creator/get-sample-slide.md new file mode 100644 index 0000000..aad025b --- /dev/null +++ b/.claude/skills/marp-creator/get-sample-slide.md @@ -0,0 +1,30 @@ +# サンプルスライドの取得 + +サンプルスライドはアップデートにより変更される可能性があるため、必ず以下のコマンドで最新版を取得する。 + +## 取得コマンド + +```bash +curl -s https://raw.githubusercontent.com/classmethod/classmethod-marp-theme/main/sample-slide.md +``` + +このコマンドを実行すると、以下の情報を含むサンプルスライドが取得できる。 + +- 各レイアウトクラスの使用例 +- Front matterの記述方法 +- 画像配置の記法 +- コメント記法(``) +- カラムレイアウトやコンテンツ幅調整の例 + +## 取得タイミング + +以下の場面でサンプルスライドを取得する。 + +- Marp資料を作成する前(build-marp実行時) +- レイアウトの使い方を確認したいとき +- 新しいレイアウトクラスの記法を調べたいとき + +## 注意事項 + +- ローカルにキャッシュされたsample-slide.mdは古い可能性があるため、常に上記コマンドで最新版を取得する +- 取得したサンプルを参照しながらMarpファイルを作成する diff --git a/.claude/skills/marp-creator/organize-content.md b/.claude/skills/marp-creator/organize-content.md new file mode 100644 index 0000000..e4f5458 --- /dev/null +++ b/.claude/skills/marp-creator/organize-content.md @@ -0,0 +1,179 @@ +# 内容整理(ステップ1) + +散在するメモや箇条書きを、論理的に整理された構造化Markdownファイルに変換する。この段階ではMarpの記法やスライド枚数を意識せず、伝えたい内容の構造化に集中する。 + +## 入力 + +ユーザーから以下の情報を受け取る。 + +| 項目 | 説明 | 形式 | +|------|------|------| +| メモファイル | 整理対象の内容 | Markdownファイルまたはテキスト | +| 資料の目的 | 提案書、勉強会、説明資料など | テキスト | +| 対象者 | 顧客、社内メンバー、エンジニアなど | テキスト | +| 出力先 | ファイルの配置場所(任意) | パス | + +出力先が指定されていない場合は、入力ファイルと同じフォルダに出力する。 + +## 出力 + +`01_organized_[資料名].md` を生成する。 + +### ファイル構造 + +```markdown +# [資料タイトル] + +## 資料の概要 + +**目的:** [資料の目的を1〜2文で記載] +**対象者:** [想定する読者・聴衆] +**作成日:** [YYYY-MM-DD] + +--- + +## [メイントピック1] + +[導入文や概要を地の文で記載] + +### [サブトピック1-1] + +[内容を説明] + +- 必要に応じて箇条書き +- 2項目程度なら地の文でも可 + +### [サブトピック1-2] + +[内容を説明] + +**図表:** [ここに○○の図を挿入予定] + +--- + +## [メイントピック2] + +... + +--- + +## 補足・メモ + +[追加情報や検討事項があれば記載] +``` + +### 出力時の注意事項 + +- 見出しレベルはh1〜h3を使用(h4以降は原則使わない) +- 箇条書きは3項目以上の並列な内容で使用 +- 2項目程度なら「AとB」のように地の文で記載 +- 図表の配置位置を `**図表:**` で明示 +- セクション間は `---` で区切る + +## ワークフロー + +### Step 1: 入力の確認 + +ユーザーから提供されたメモファイルを読み込み、以下を確認する。 + +- 資料の目的(提案書、勉強会資料、説明資料など) +- 対象者(顧客、社内メンバー、技術者レベルなど) + +資料の目的と対象者が明示されていない場合は、AskUserQuestionツールで確認する。出力先は入力ファイルと同じフォルダに配置する。 + +### Step 2: トピックの抽出 + +メモから主要なトピックを洗い出す。以下の観点で分析する。 + +- 何について説明するのか(主題) +- なぜそれを伝えるのか(目的) +- どのように説明するのか(手順、比較、事例など) + +重複する内容や関連性の高い項目をグループ化する。 + +### Step 3: 論理的な並び替え + +トピックを適切な順序に配置する。 + +**提案書の場合:** +1. 現状の課題 +2. 解決策の提案 +3. 実現方法 +4. 期待される効果 +5. 次のステップ + +**勉強会資料の場合:** +1. 背景・動機 +2. 基礎知識 +3. 具体的な内容(デモ、事例など) +4. まとめ・次のアクション + +**説明資料の場合:** +1. 概要 +2. 詳細説明(機能、仕様など) +3. 使い方・運用方法 +4. 補足情報 + +資料の目的に応じて柔軟に構成を調整する。 + +### Step 4: 見出しレベルの調整 + +見出しの階層を整理する。 + +- h1: 資料タイトルとメイントピック +- h2: サブトピック +- h3: さらに細分化が必要な場合のみ + +h4以降は使用しない。階層が深くなる場合は、トピックの分割を検討する。 + +### Step 5: 箇条書きと地の文の使い分け + +**箇条書きを使う:** +- 3つ以上の並列な項目 +- 手順やステップ +- チェックリストや仕様一覧 + +**地の文を使う:** +- 2つ程度の項目(「AとB」のように文中で述べる) +- 因果関係や論理の流れがある内容 +- 説明や考察 + +### Step 6: 不足要素の確認 + +整理後の内容を見直し、以下が不足していないか確認する。 + +- 各トピックの説明が十分か +- 論理の飛躍がないか +- 図表が必要な箇所で明示されているか +- 対象者にとって分かりやすい表現か + +不足が見られる場合は、ファイル末尾の「補足・メモ」セクションに記載する。 + +### Step 7: ファイル出力 + +指定された出力先に `01_organized_[資料名].md` を作成する。 + +ファイル作成後、以下をユーザーに伝える。 + +- 出力ファイルのパス +- 主要なトピック構成の概要 +- 追加で検討が必要な項目(あれば) +- 次のステップ(slide-design)への案内 + +## 判断基準 + +| 項目 | 基準 | +|------|------| +| トピックの粒度 | 1トピックで5〜10分程度説明できる内容 | +| 見出しレベル | h1〜h3まで、h4以降は使わない | +| 箇条書き項目数 | 3〜7項目程度。それ以上なら分割を検討 | +| 1段落の長さ | 3〜5文程度。長い場合は段落を分ける | +| 図表の必要性 | 言葉だけで説明しにくい箇所には図表を推奨 | + +## エラー対処 + +| エラー | 原因 | 対処 | +|--------|------|------| +| 入力ファイルが読めない | パスが間違っている | ユーザーに正しいパスを確認 | +| 資料の目的が不明 | 情報が不足している | AskUserQuestionで確認 | +| トピックが抽出できない | メモが断片的すぎる | ユーザーに追加情報を依頼 | diff --git a/.claude/skills/marp-creator/slide-design.md b/.claude/skills/marp-creator/slide-design.md new file mode 100644 index 0000000..a43b1cc --- /dev/null +++ b/.claude/skills/marp-creator/slide-design.md @@ -0,0 +1,210 @@ +# スライド設計(ステップ2) + +整理済みMarkdown(organize-contentの出力)から、スライド設計書を作成する。この設計書は、最終的なMarp資料を生成する前の中間成果物であり、スライド構成を事前確認できる。 + +## 入力 + +ユーザーから以下の情報を受け取る。 + +| 項目 | 説明 | 形式 | +|------|------|------| +| 整理済みファイル | organize-contentの出力 | `01_organized_[資料名].md` | +| スライド枚数の目安 | 希望するスライド枚数(任意) | 数値(例:20枚程度) | +| 発表時間 | プレゼン時間(任意) | 分単位(例:15分) | + +スライド枚数や発表時間が指定されていない場合は、内容から適切な枚数を判断する。出力先は入力ファイルと同じフォルダに配置する。 + +## 出力 + +`02_slide-design_[資料名].md` を生成する。 + +### ファイル構造 + +```markdown +# スライド設計書: [資料タイトル] + +**作成日:** [YYYY-MM-DD] +**想定スライド枚数:** [X]枚 +**想定発表時間:** [Y]分 + +--- + +## スライド構成一覧 + +| No. | タイトル | レイアウト | 備考 | +|-----|----------|-----------|------| +| 1 | [資料タイトル] | title | 表紙 | +| 2 | [セクション名] | section | 第1章の開始 | +| 3 | [具体的なタイトル] | 基本 | 箇条書き3項目 | +| ... | ... | ... | ... | +| N | (裏表紙) | all-text-center align-center | ロゴのみ | + +--- + +## スライド詳細 + +### スライド1: [資料タイトル] + +**レイアウト:** title +**ページネーション:** false + +**内容:** +- タイトル: [資料タイトル] +- サブタイトル: [日付や執筆者情報] +- ロゴ: ClassMethodロゴ + +--- + +### スライド2: [セクション名] + +**レイアウト:** section +**ページネーション:** false + +**内容:** +- セクションタイトル: [セクション名] +- 説明文: [1〜2文の説明] + +--- + +### スライド3: [具体的なタイトル] + +**レイアウト:** 基本 + +**内容:** +- タイトル: [具体的なタイトル] +- 本文: + - [ポイント1] + - [ポイント2] + - [ポイント3] +- 参考リンク: [リンクタイトル](URL)(該当する場合のみ) + +--- + +[以下、全スライドの詳細を記載] + +--- + +## レビューポイント + +設計書確認時に以下を検討してください。 + +- [ ] 各スライドの情報量は適切か +- [ ] スライドの順序は論理的か +- [ ] 図表の配置は適切か +- [ ] 全体の流れにメリハリがあるか +- [ ] 想定時間内に収まるスライド枚数か +``` + +## ワークフロー + +### Step 1: 整理済みファイルの読み込み + +`01_organized_[資料名].md` を読み込み、以下を把握する。 + +- 資料の目的と対象者 +- メイントピックの数と内容 +- サブトピックの構造 +- 図表が必要な箇所 +- 参考リンク(該当する箇所に引き継ぐ) + +### Step 2: スライド枚数の決定 + +発表時間や内容量から、適切なスライド枚数を決定する。 + +**判断基準:** +- 1スライドあたり30秒〜1分程度を想定 +- 表紙、セクションスライド、裏表紙を含める +- 内容スライドは1スライド1メッセージを基本とする + +### Step 3: スライドの分割 + +整理済み内容を個別のスライドに分割する。 + +**分割の基準:** +- 1スライドに箇条書き5項目まで +- 長い説明は複数スライドに分割 +- 図表がある場合は専用スライドを用意 +- トピックの切り替わりでセクションスライドを挿入 + +### Step 4: レイアウトの選択 + +各スライドに適したレイアウトクラスを選択する。 + +| レイアウトクラス | 使用場面 | +|-----------------|----------| +| title | 表紙(1枚目) | +| section | セクション区切り(大きなトピックの開始時) | +| (指定なし)基本 | テキスト中心のスライド、箇条書きが主体 | +| image | 図表のみを大きく表示したい場合 | +| content-image | 図表とキャプションを組み合わせる場合 | +| content-image-right | 文章と図表を横並び(図が右) | +| content-image-left | 文章と図表を横並び(図が左) | +| column-layout | 複数項目を横並びで比較する場合 | +| small-text | 情報量が多く、文字を小さくする必要がある場合 | +| all-text-center align-center | 裏表紙(最終スライド、ロゴのみ中央配置) | + +**選択の指針:** +- デフォルトは基本レイアウト +- 図表がある場合は image, content-image, content-image-right/left を選択 +- 比較表や複数の選択肢を示す場合は column-layout +- 情報量が多い場合は内容を分割。分割が難しい場合のみ small-text + +### Step 5: 1スライドあたりの情報量調整 + +各スライドの情報量を適切に調整する。 + +**情報量の目安:** +- タイトル: 10〜20文字程度 +- 箇条書き: 3〜5項目 +- 各箇条書き項目: 20〜40文字程度 +- 説明文: 2〜3文程度 + +情報量が多すぎる場合は、スライドを分割するか、内容を簡潔にする。 + +### Step 6: 図表の配置指示 + +図表が必要な箇所を明示する。 + +- どのような図表が必要か(構成図、フロー図、グラフなど) +- 図表のサイズ(幅の目安:w:400px, w:700px など) +- 図表とテキストの配置関係 + +図表の実際のファイルは、Marp資料作成時に配置する。 + +### Step 7: 全体の流れ確認 + +スライド全体の流れを確認し、以下をチェックする。 + +- 論理的な順序になっているか +- 各セクションの分量バランスは適切か +- メリハリがあるか(セクションスライドの配置) +- 冗長な部分はないか + +### Step 8: スライド設計書の出力 + +`02_slide-design_[資料名].md` を出力する。 + +ファイル作成後、以下をユーザーに伝える。 + +- 出力ファイルのパス +- 想定スライド枚数 +- レビューポイント +- 次のステップ(build-marp)への案内 + +## 判断基準 + +| 項目 | 基準 | +|------|------| +| 1スライドの情報量 | 箇条書き3〜5項目、または2〜3文の説明 | +| スライド枚数 | 発表時間(分)× 1〜1.5枚 | +| セクションスライド | 3〜5スライドごと、または大きなトピックの切り替わり | +| 図表専用スライド | 図表が主要な説明要素の場合は専用スライドにする | +| レイアウト変更 | 単調にならないよう、5〜7スライドごとにレイアウトを変える | + +## エラー対処 + +| エラー | 原因 | 対処 | +|--------|------|------| +| 整理済みファイルが読めない | パスが間違っている | ユーザーに正しいパスを確認 | +| 内容が少なすぎる | 整理済みファイルの内容不足 | organize-contentの再実行を提案 | +| スライド枚数が適切に決まらない | 発表時間や内容量が不明 | ユーザーに希望枚数を確認 |