入口

進階老師當架構師

跳到…
動畫版
列印

第 3 部・動手做:兩條路線5 分鐘10 / 20

認識範本包

認識範本包:第 3 部動畫第 4 幕的畫面
在動畫版看這一段 ›第 3 部動畫・第 4 幕

範本包是一門三週示範課的維護資料夾,結構照第 2 部的六層架構安排。開工前先花五分鐘看懂它,後面四輪才知道 Agent 在做什麼。

範本包的結構
位置 是什麼 屬於哪一層 誰可以改
AGENTS.md 專案規則:來源優先順序、可以與不可以做的事、狀態怎麼改、做完回報什麼 規則 老師
CLAUDE.md 第一行是 @AGENTS.md(下面另有一行說明註解),讓 Claude Code 讀到同一份規則 規則 老師
HANDOFF.md 目前狀態、上一段做了什麼、還沒做完的事、老師核定紀錄 狀態 Agent 更新各段;「老師核定紀錄」只由老師寫
00_core/course-spec.md 示範課的課程規格:每週單元的格式、必要段落、講義長度 能力 老師
00_core/status.json 每一週的原稿、鏡像、講義各在什麼狀態 狀態 Agent 更新;approved 與 published 只能依老師的核定紀錄設定
01_source/ 三週的教材原稿(正式版本) — Agent 依要求修改
02_requests/ 老師寫的修改要求 — 老師
03_mirror/ 給筆記本用的鏡像:原稿去掉教師專用段落;manifest.csv 記下每一次產生的紀錄 — 只能由程式重新產生,不手改
04_handouts/ 給學生的講義草稿 — Agent 依核准的原稿產生
05_reviews/ 審查紀錄 驗證 負責審查的 Agent(只能新增審查紀錄)
scripts/ build_mirror.py 產生鏡像;check.py 檢查已經寫成程式的規則,並印出各週的版本碼 執行、驗證 老師
prompts/ 四輪練習的提示詞 P1–P4,以及沒有付費方案時用的 P5 — 練習時不用改
workflow/ 工作流程設計表的示範與設計題 — 老師(設計題可以直接寫在上面)

表中「屬於哪一層」寫「—」的,是被維護的教材與練習材料本身,不屬於六層裡的任何一層。status.json 的狀態用英文記錄:none 是還沒有這個檔案,draft 是草稿,reviewed 是已經審查,approved 是老師已核准,published 是已發給學生。

這個資料夾的安排,分別回答了第 2 部的四個問題。「誰可以改什麼」寫在 AGENTS.md 和上表的最後一欄。「做完怎麼證明」靠 check.py 的檢查結果,以及 AGENTS.md 規定的回報格式。「哪一步一定要老師」:approved 與 published 只能依老師在 HANDOFF.md 親手留下的核定紀錄設定,Agent 照紀錄更新,並在回報中引用那一行。「下一個人從哪裡接」:看 HANDOFF.md。

老師的核定紀錄,每一行都附上一個版本碼,例如 HANDOFF.md 裡的 - 2026-10-07 核定:W03 原稿 版本 a4ec9ff5(林老師)。範本包用 W01、W02、W03 代表第 1、2、3 週。版本碼是 check.py 從檔案內容算出來的 8 個字元,印在 check.py 輸出的第一節「版本碼」。原稿改過一個字,版本碼就會不同,舊的核定也就不再算數。第四輪會用到它。

原稿裡有一種特別的段落,用 <!-- 教師專用 --> 和 <!-- /教師專用 --> 包起來,寫的是給老師看的教學提醒與參考答案。產生鏡像時,這些段落會被拿掉,學生在筆記本裡就問不到。Explorer 裡從「教材原稿」到「雲端硬碟閱讀副本」的那一步,做的就是這件事。

本頁收穫

  • 範本包照六層架構安排:規則、狀態與課程規格放在最前面;後面的資料夾依序是原稿、鏡像與講義,鏡像和講義都從原稿產生。
  • 教師專用段落只留在原稿;鏡像由程式產生,不手改。
  • 核定紀錄的每一行都附上版本碼;檔案改過,舊的核定就不算數。