轉為投影片
為一個單元建立投影片。請閱讀 COURSE-CANVAS.md、RESOURCES.md、DECISIONS.md、AGENTS.md 中的 ## Agentic course creation 章節,以及該單元已核准的授課計畫和學員頁面。投影片是根據授課計畫建立的,絕非反過來:如果授課計畫尚未核准,請停止並建議使用 /draft-unit。
1. 確定格式一次
格式通常會在 /setup-course 中確定。如果 AGENTS.md 中沒有 Slides: 這一行,請提問,並根據現有內容(舊的投影片、區塊 5 中的工具)提出建議:
-
格式與工具:例如 claude.ai Slides 成品、
.pptx、Google Slides、Markdown 投影片(Marp、reveal.js)。 -
投影片存放位置以及誰能看到:僅在課堂上展示,或課後發布給學員。發布的投影片屬於學員教材。
-
模板:要遵循其外觀風格的現有投影片或設計系統。
-
大綱存放位置:建議放在授課計畫旁邊的私有資料夾中(例如
slides/<unit>-outline.md),因為大綱包含樣本答案。
將答案以 - Slides: <format>, <deck location>, <outline location>, <published to participants: yes|no>, template <link> 的格式寫入 AGENTS.md,並記錄在 DECISIONS.md 中。
2. 根據計畫建立大綱
在開始建立任何投影片之前,先將大綱寫入其檔案:一個時間表(計畫分鐘數、每個區塊的投影片數與每張投影片的分鐘數),然後是授課計畫中每個區塊的條目,依其順序排列:
- 開場:一張封面和一張議程投影片,列出計畫中的區塊與分鐘數,即使計畫中沒有列出它們。
- 輸入區塊:一個依其分鐘數調整大小的章節(通常每兩到三分鐘一張內容投影片)。列出每張投影片的主張及其來源:授課計畫、其樣本答案、課程大綱、學員頁面。數字來自計畫的樣本答案或重新計算,絕不能憑空發明。當計畫僅提供一個關鍵字(例如「尺度類型」)時,請勿根據自己的知識填寫:將該投影片標記為「計畫中缺少內容」並將其作為一個決策。
- 小組作業:一張任務投影片,使用與學員頁面相同的措辭說明任務、時間限制、預期成果、工作地點(儲存庫、資料、起始 notebook)以及提交或繳交地點。載入
learner-instructions。如果學員頁面未包含任務(課堂中的任務通常僅存在於授課計畫中),請使用計畫中的措辭並標記它:此時該投影片是學員看到任務的唯一地方,無論投影片是否發布,它都屬於學員教材。將任何存在多種合理解讀方式的任務(例如「平均」是按天還是按行)標記為決策。 - 全體討論:一張投影片,包含問題或回饋標準。課堂上產生的內容(小組的回答、圖表)會有一個空白框架供現場填寫。
- 影片測驗:來自
RESOURCES.md的測驗連結(以及格式允許時的 QR code),而非問題;答案與解釋僅放在講師備註中。如果該單元還沒有測驗,請先建議使用/to-quiz。 - 休息、展望:各一張投影片;展望投影片使用學員頁面上的措辭重複作業內容。
標記所有會在學員開始作業前就揭露樣本答案的投影片。這些投影片應放在任務投影片之後,作為隱藏或備用投影片,或者將其從發布的投影片中排除。
在大綱結尾列出其需要的決策(超載的區塊、缺失的內容、模糊的任務、投影片是否發布),每個決策附上選項與建議,以及 course-checks 中已經可以對大綱執行的投影片檢查結果。顯示大綱並等待講師。這是停止點;對內容的編輯應先修改授課計畫,然後再修改大綱。
3. 建立
以已確定的格式和模板建立投影片組:
- 每張投影片的標題應陳述其要點(「大多數預測誤差發生在國定假日」),而非一個主題(「結果」)。
- 文字要少;講師要說的內容屬於講師備註,取自授課計畫。
- 每個連結、儲存庫名稱、指令和截止日期必須與
RESOURCES.md中的來源完全一致。 - 即時示範應準備一張備用投影片(螢幕截圖或預期輸出),以防示範失敗。
4. 檢查與交接
執行來自 course-checks 的投影片檢查(與計畫和學員頁面的一致性、時間控制、無提前的樣本答案、連結正確性)。修正失敗的項目,然後顯示投影片組,並附上您不確定的投影片清單。
投影片是鏡像:它們重複來自授課計畫和學員頁面的事實,包括其中的空白。將每份投影片加到 RESOURCES.md 中這些事實的鏡像列表中,以便對頁面的修正也能同步更新到引用它的投影片。
如果投影片會發布給學員,請將核准的投影片發布到手冊:將其匯出為 PDF(當投影片工具只能手動匯出時,請要求講師匯出並確切告知儲存位置),以單元名稱命名(例如 week-02-slides.pdf),放在 AGENTS.md 中指定的手冊資產路徑下,從匯出中移除講師備註和隱藏答案投影片,並在該單元學員頁面的教材部分下建立連結。後續對投影片的修改意味著需要重新匯出;手冊中的 PDF 是投影片的鏡像。
當講師已核准投影片、RESOURCES.md 中已將其列為該單元的 draft 狀態、其位置已從授課計畫連結,並且(如果已發布)PDF 已從該單元學員頁面連結時,即完成。如果投影片已發布給學員,請建議下一步執行 /walk-through <unit>;否則執行 /review-unit <unit>。