marp-presentation

# Marp プレゼンテーション スキル `.github/copilot-instructions.md` をプレゼン資料の source of truth として扱う。 このスキルはスライドの内容を Marp 形式で `slide-show.md` に書き出すことで、 Marp プレビューアー上でスライドショーを実現する。 ## コンテンツの読み取りルール 1. `.github/copilot-instructions.md` の `## ` 見出しを 1 枚のスライドとして扱う 2. スライドタイトルは見出し名をそのまま使う 3. スライド本文は、その見出し配下の箇条書き、段落、リンクを材料にして構成する 4. スライド数、順番、ラベル、本文を SKILL.md にハードコードしない 5. 見出しより前にある本文は補助情報として扱い、スライド本文には含めない 6. スライド本文が自然言語でだけ書かれている場合は内容を変えない範囲でスライド表示に適した形に整形する ## 動作フロー 1. スキルが呼び出されたら、最初のスライドから開始する 2. 現在のスライドの内容を Marp 形式でリポジトリルートの `slide-show.md` に書き出す 3. スライド書き出し後、`ask_user` でナビゲーションだけを聞く 4. ユーザーの選択に応じて次のスライド、前のスライド、または指定スライドへ移動する 5. 移動先のスライドを `slide-show.md` に上書きする 6. これをユーザーが終了するまで繰り返す ## slide-show.md の書き出しルール - ファイルの先頭に Marp フロントマターを必ず付ける: ``` --- marp: true theme: default paginate: false --- ``` - フロントマターの後に 1 枚ぶんのスライド内容だけを書く - スライドタイトルは `# ` (h1) として書く - 本文はマークダウンでそのまま書く（箇条書き、リンク等を維持） - 表紙スライド（最初の `##` 見出し）は特別扱いする: - Marp のローカルディレクティブ `<!-- _class: lead -->` を付けて中央寄せにする - `<!-- _paginate: false -->` でページ番号を非表示にする - セッションタイトルを `# ` (h1) で大きく表示する - イベント名・開催日はタイトルの上にサブテキストとして小さく表示する - 登壇者名はタイトルの下に表示する - スライド区切り (`---`) は使わない（常に 1 ページだけ表示する） - ファイルは毎回全体を上書きする（create ではなく edit または create を使い分ける。ファイルが存在する場合は edit の old_str を省略して全置換する） - 1 枚のスライドでは 1 つの見出しの内容だけを扱う - ページ番号は Marp の `paginate: false` で非表示にするため、スライド本文には含めない ## ask_user のルール - `question` には次のスライドの内容をプレビューとして含める。次のスライドのタイトル・本文をそのまま表示し、最後にナビゲーション案内を添える - 末尾スライドの場合は次のスライドが存在しないため「最後のスライドです」と表示する - choices は現在のスライド位置に応じて動的に作る - 先頭スライドでは「次へ」「スライド一覧」「終了」を出す - 末尾スライドでは「前へ」「スライド一覧」「終了」を出す - 途中のスライドでは「次へ」「前へ」「スライド一覧」「終了」を出す - 「スライド一覧」を選んだ場合は、見出しから作った全スライド一覧を choices に出す ## 初回起動時の補助 - スキル起動時に `slide-show.md` がまだ存在しない場合は `create` で新規作成する - 既に存在する場合は内容を全置換する（edit ツールで old_str にファイル全文を指定して new_str に新しい内容を書く） ## 終了時 - ユーザーが「終了」を選んだら、スライドショーを終了する旨を伝える - `slide-show.md` はそのまま残す（削除しない）