範本包是一門三週示範課的維護資料夾,結構照第 2 部的六層架構安排。開工前先花五分鐘看懂它,後面四輪才知道 Agent 在做什麼。
| 位置 | 是什麼 | 屬於哪一層 | 誰可以改 |
|---|---|---|---|
| AGENTS.md | 專案規則:來源優先順序、可以與不可以做的事、狀態怎麼改、做完回報什麼 | 規則 | 老師 |
| CLAUDE.md | 第一行是 @AGENTS.md(下面另有一行說明註解),讓 Claude Code 讀到同一份規則 |
規則 | 老師 |
| HANDOFF.md | 目前狀態、上一段做了什麼、還沒做完的事、老師核定紀錄 | 狀態 | Agent 更新各段;「老師核定紀錄」只由老師寫 |
| 00_core/ |
示範課的課程規格:每週單元的格式、必要段落、講義長度 | 能力 | 老師 |
| 00_core/ |
每一週的原稿、鏡像、講義各在什麼狀態 | 狀態 | 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 裡從「教材原稿」到「雲端硬碟閱讀副本」的那一步,做的就是這件事。
本頁收穫
- 範本包照六層架構安排:規則、狀態與課程規格放在最前面;後面的資料夾依序是原稿、鏡像與講義,鏡像和講義都從原稿產生。
- 教師專用段落只留在原稿;鏡像由程式產生,不手改。
- 核定紀錄的每一行都附上版本碼;檔案改過,舊的核定就不算數。
