單張投影片提示文撰寫(CardFrontmatter)
用途
把 Layer 2 課程單元壓縮為 CardFrontmatter 格式的投影片提示文,含三個區塊:講師口白條列、投影片視覺說明、學員互動 Prompt(T10 任務卡才填),讓 coursedeck Phase B2 可以直接渲染成可用投影片。
何時用
- 適合:投影片大綱(outline.md)已確定、需要逐張撰寫投影片內容與圖像生成提示文時使用。
- 不要用:尚未完成 outline.md 就想先寫投影片內容,這樣很容易做白工——等到大綱調整,已寫的張數可能全部重來。
Prompt
text
請執行 Phase B2:把來源課程內容壓縮為 CardFrontmatter 格式的投影片提示文。
來源檔案:{{content.md 路徑,例如 ch01-intro/l1-what-is-ai/content.md}}
對應大綱:{{outline.md 中該投影片的條目,例如 Slide 03 概念說明 [T3]}}
投影片編號:{{Slide NN,例如 Slide 03}}
請用以下格式輸出 CardFrontmatter:
---
page: {{NN}}
section: {{章節名稱}}
slide_id: {{課程id}}-s{{NN}}
render: {{模板代號,例如 T3}}
title: {{投影片標題}}
instructor_notes:
- {{講師口白第 1 條,≤20 字,口語化}}
- {{講師口白第 2 條}}
- {{講師口白第 3 條(最多 3 條)}}
visual_prompt: {{投影片視覺描述,用於 AI 圖像生成,英文或中文均可}}
image_prompt: {{詳細 AI 圖像提示文,含尺寸、風格、內容、禁止項目}}
learner_prompt: {{T10 任務卡才填;其他模板留空或省略}}
---
授權頁尾:在最後加上「本投影片依 Layer 2 內容壓縮,來源:{{source_path}}」
品質標準:
- 講師口白:≥1 句包含 Alex 簽名語句(「簡單來說」「重點來了」「你有沒有遇過這種情況?」)
- 禁用詞:絕對、最好的(「不一定」可以)
- 視覺說明要明確到可以讓設計師或 AI 直接執行範例 / 變體
- 填好變數:來源填「ch02-tools/l3-prompt-basics/content.md」、大綱條目填「Slide 07 Prompt 的三個組成要素 [T3]」、投影片編號填「Slide 07」。
- 變體(批次產出):把多張投影片的條目一次貼入,要求「依序輸出每張的 CardFrontmatter,中間用 --- 分隔」,適合在大綱穩定後一次產出一個章節。
- 變體(只要口白):如果只需要講師口白草稿確認教學邏輯,可說「只輸出 instructor_notes,其他欄位跳過」快速預覽。
🎯 範例輸出(實測)
在 Claude.ai 跑這句、把
{{變數}}填成「來源檔案ch02-tools/l3-prompt-basics/content.md(內容:Prompt 的三個組成要素:角色、任務、情境)、大綱條目Slide 07 Prompt 三個組成要素 [T3]、投影片編號Slide 07」的結果:
點開看 AI 實際輸出
yaml
---
page: 07
section: Ch2 工具入門
slide_id: course-ai-studio-0to1-s07
render: T3
title: Prompt 的三個組成要素
instructor_notes:
- 簡單來說,一個好的 Prompt 不是靠運氣——是靠這三個結構
- 角色讓 AI 知道「你是誰」;任務說清楚「要做什麼」;情境補上「在什麼條件下」
- 少掉任何一個,AI 給的答案就會像在猜謎
visual_prompt: 三欄卡片版面,米白底,每欄一個 Lucide 圖示 + 中文標題 + 一行說明;標題列「Prompt 的三個組成要素」
image_prompt: |
[Style preamble: flat design, #F8F6F2 background, Lucide icons 2px stroke brand blue #1D4ED8, Noto Sans TC]
1920×1080px 課程投影片,三欄卡片並排:
左欄:icon=user-circle,標題「角色」,說明「告訴 AI 它要扮演誰」
中欄:icon=check-square,標題「任務」,說明「明確說你要它做什麼」
右欄:icon=info,標題「情境」,說明「補上限制條件或使用場景」
頂部標題 56px Bold,底部品牌欄「雲端方程式 × AI 培訓」#1D4ED8 底白字。
扁平設計,足夠留白,無漸層,無真實人物。
learner_prompt:
---
本投影片依 Layer 2 內容壓縮,來源:ch02-tools/l3-prompt-basics/content.md💡 實測心得:instructor_notes 的第一條一定要包含 Alex 簽名語句(這裡用了「簡單來說」),這是品質門檻裡最容易忘記的一條;image_prompt 記得把 Style preamble 帶進去,不要每次從頭描述風格,統一風格的 preamble 才是省時的關鍵。
延伸
重點來了:image_prompt 欄位是整份 CardFrontmatter 最常被忽略但最影響品質的部分——視覺描述太模糊,生成的圖就像隨機抽卡。建議搭配「AI 生圖投影片 Style Preamble 撰寫」prompt 先定義全套視覺風格,再每張填入具體內容,批量生成才會一致。