草擬一個單元
草擬一個單元的資源。讀取 COURSE-CANVAS.md、PLAN.md、PERSONAS.md、RESOURCES.md、DECISIONS.md 以及前一個單元的材料。沿用課程現有檔案的結構(標題、表格、語氣);如果課程尚未有結構,請提出一個並等待確認。
1. 先寫路徑
在編寫任何內容之前,先在授課檔案的教師筆記中,以編號列表的形式撰寫該單元的學習者路徑:學習者從開啟學員頁面到提交成果的每一步,每步包含:
- 他們需要的內容(概念、工具、檔案、連結、帳號)及其來源(邊界、前一個單元、此頁面),
- 他們可以看到的預期結果。
載入 assumed-knowledge。如果某步驟的需求沒有來源,即為缺口:立即解決它——新增步驟、連結或說明,或將其交給教師處理。顯示路徑並等待確認;這是教材將據以檢查的規格。
2. 草擬
根據 RESOURCES.md 草擬單元所需的內容,各自放在對應位置:
- 教師:包含時間安排、輸入、小組活動、範例答案與討論要點的授課計劃。將輸入區塊撰寫為內容(主張、數字、範例),並考慮講者備註;稍後可透過
/to-slides從中建立投影片。 - 學員:目標、任務、成果、材料及長度。載入
learner-instructions。 - 範本或程式碼:任務所需的筆記本、資料、組態。
透過在課程資料上執行程式碼來計算範例答案,切勿憑記憶。引用數字時說明計算方式。
3. 停止點
顯示草稿,並附上你做出的選擇清單(任務用語、選用哪個影片、多少內容為選修)以及不確定的部分。教師進行編輯或批准。將影響其他單元的選擇記錄到 DECISIONS.md。
當教師已批准草稿且 RESOURCES.md 將該單元列為 草稿 時,即完成。如果單元有輸入區塊,建議執行 /to-slides <unit>,然後執行 /walk-through <unit>;切勿在此技能中將單元標記為 已發布。