AI賦能創新教學－Gemini Notebook教學實作工作坊（進階）

初階課處理的是「一本筆記本」：讓學生在筆記本裡問到的內容、筆記本助教的回答和講義上印的文字，都來自同一個版本。進階課再往前一步，處理「一整學期」：每一週都有教材、作業、講義和筆記本來源要更新。這些工作如果交給 AI Agent（可以自己讀寫資料夾裡的檔案、執行程式，一步一步把工作做完的 AI 工具）去做，老師要怎麼設計，它才會照規則做、做完拿得出證據，而且在該停的地方停下來？

今天的答案是：老師當架構師，決定規則怎麼寫、工作怎麼分，以及哪些步驟一定要等你同意。你不需要會寫程式，但要會寫三份文件：規則、狀態、要求。Agent 開工前先讀這三份文件，做完之後再把結果寫回狀態文件。

林老師（虛構的人物）的課開學第五週，她做了一張表，把每一週要更新的東西列出來，然後沉默了很久。

她可以拿講師這學期在元智教的管理學（課號 CM108G）來估算。這門課每一週都要產出或更新下面這些東西，而且彼此相依：教材改了，動畫、講義、筆記本來源都要跟著改。

十八週乘上這六種產出，再加上中英兩種語言，一學期是上百個檔案。更麻煩的是順序：上一週的逐字稿沒有核准，這一週的教學設計就不該開始；教材沒有發布，動畫就不該做。

講師這學期把很多這類工作交給 Codex 和 Claude 這兩種 Agent 處理。他學到的第一件事是：Agent 做得很快，出錯也一樣快。下一頁看幾個實際發生過的狀況。

最直覺的做法，是開一個對話，對 AI 說：「幫我把第 6 週的東西都更新好。」這句話會得到一個看起來很完整的結果。問題藏在看不見的地方。

下面三個狀況，前兩個是 CM108G 這學期真的發生過的事，講師的交接紀錄裡都有記載；第三個是把所有事情放在一次對話裡做完時，最常見的情形。

這三個狀況，換一個更聰明的 AI 也避免不了，因為問題出在工作方式少了三樣東西：一份規則，寫清楚「正式版本在哪裡、哪些不能碰」；一份狀態，記錄「現在做到哪裡」；一個檢查，說清楚「做完要拿出什麼證據」。第 2 部要把這三樣東西整理成固定的架構，每次開工都照著用。

把一學期的課程維護交給 Agent，可以把整件工作想成一個小型施工團隊在做。團隊裡有三種角色，各自負責不同的事。

表中有幾個詞，後面會一直用到。「閘門」是流程裡一定要停下來、等老師明確同意才能往下做的地方，例如發布給學生之前。「工作階段」是和 Agent 的一次連續對話；開一個新的工作階段，等於找一個沒看過前面對話的 Agent。「子 Agent」是主要的 Agent 另外派出去、處理一小件工作的 Agent。「鏡像」是程式從教材原稿產生、給筆記本讀的副本，內容和原稿相同，只拿掉給老師看的段落。

這個分工有兩個重點。

第一，老師的位置往上移了。逐一修改檔案的工作交給 Agent，老師負責設計「誰可以改什麼、改完怎麼證明、哪一步要停下來等我」。這些決定寫成文件之後，不管用 Claude 還是 Codex，也不管換成哪一個 Agent，都會照同一套規則做事。

第二，指揮不等於全權。10 月 4 日晚上，講師為 CM108G 同時派了兩個 Agent：一個重做第 3 到 5 週的教材動畫，一個修改第 5 週的課堂表單。兩個 Agent 共用同一份「一致性基準文件」，裡面規定了用語、角色、教材裡三個選項的說明，以及練習情境的時間線，避免兩邊各寫各的。隔天凌晨，講師逐項回答了十九個需要他決定的問題，Agent 才照這些決定修改。派工可以交給指揮，決定權留在老師手上。

上一頁的分工，要靠資料夾裡的文件、程式和固定做法來執行。這些東西可以分成六層，每一層回答一個問題，也對應一種檔案或做法。下表用 CM108G 這學期的實際做法當示範。

前兩層是今天動手做的重點。規則放在 AGENTS.md，因為 Codex 開工時會自動讀它；Claude Code 自動讀的是 CLAUDE.md，所以在 CLAUDE.md 第一行寫 @AGENTS.md，兩個工具就讀到同一份規則。狀態放在 HANDOFF.md，但兩個工具都不會自動讀這個檔名，所以要在 AGENTS.md 裡寫明「開工先讀 HANDOFF.md，收工前更新它」。

第五層的「盲測」，是請一個沒看過製作過程的 Agent，只拿著文件做事或作答，看文件本身寫得夠不夠清楚。下面是一個實際的例子。講師在 10 月 5 日寫完動畫規格書後，另開一個 Agent，只給它規格書和第 6 週教材網頁，不准讀其他檔案，請它一次做出動畫。它做出了 49 幕的動畫，同時記下 28 個「規格沒寫清楚」的地方。規格書的 1.1 版就是照這 28 點修訂的。這個 Agent 沒看過製作過程，只能照規格書做，所以規格書哪裡沒寫清楚，它一做就會碰到。

兩份文件的寫法不一樣。AGENTS.md 是「長期有效的規則」，寫一次，偶爾修訂；HANDOFF.md 是「最新的狀態」，每一段工作結束都要更新。下面兩份示範，改寫自 CM108G 課程工作資料夾的實際文件，篇幅縮短了。

# 課程每週製作的專案規則

## 來源優先順序
1. 老師最新的明確指示與本週教學目的。
2. 雲端硬碟的課程同步資料夾。
3. 上一週老師核准的逐字稿與課後檢討。
4. 本專案的 HANDOFF.md 與對應週次的教材。
5. 已發布的課程網站、長個案、短個案。
教材內容一律以網站已發布的版本為準，不用本機的舊資料夾。

## 逐字稿閘門
老師校正逐字稿並標成「定稿」後，才放進核准逐字稿資料夾。
開始設計第 N 週之前，先檢查第 N−1 週有沒有還沒檢討的定稿逐字稿；
有，就先做課後檢討；沒有定稿，只回報缺少什麼，不產出可發布的教案。

## 不可以做的事
沒有老師在本輪明確授權，不發布、不寄信、不改外部平台、不刪除檔案。

# 課程每週製作｜交接

## 目前狀態（2026-10-05）
- 每週製作規格 v0.8 為正式版；第 2 到 5 週的教材動畫已發布。
- 第 6 週教材動畫有一份草稿，尚未審閱、尚未發布。

## 這一段做了什麼
- 依老師 10/5 的 19 項決定，修改第 5 週表單與教學指引。

## 還沒做完 / 需要老師決定
- 第 2 週成果的中文名稱，等老師確認。
- 第 6 週教材動畫須在 10/9 前審閱後發布。

## 從哪裡接
- 要做動畫：只讀動畫製作規格書 v1.1。
- 要發布：照網站儲存庫的規則，發布後讀回公開網址。

示範裡有兩處都在講「以什麼為準」，管的是不同的事。來源優先順序，決定指示互相衝突時聽誰的；「教材內容一律以網站已發布的版本為準」這一句，決定拿教材去做動畫等衍生材料時讀哪一份。要修改教材，還是要改原稿，再重新產生網站並發布。

AGENTS.md 有一個好用的寫法：每一條規則，盡量寫成「Agent 遇到某種情況時要怎麼做」。以上面的逐字稿閘門為例：如果只寫一句「要重視逐字稿」，Agent 不知道該做什麼。示範裡分成兩種情況，各寫一個動作：有還沒檢討的定稿，就先做課後檢討；沒有定稿，就只回報缺少什麼。CM108G 的完整版還多寫了第三種情況：逐字稿的標示互相矛盾。規則寫成「情況與動作」，Agent 知道該做什麼，老師也查得出它有沒有照做。

HANDOFF.md 則要寫到「換一個人或換一個 Agent 也接得下去」。CM108G 的交接檔還有一個習慣：每一項「已完成」都附上證據，例如提交編號（Git 版本紀錄的編號）、檔案位置、檢查結果；「沒有測到的事」也寫出來，例如沒有在 iPhone 上實測。

交給 Agent 做事之後，老師最重要的工作是看出哪裡不對勁。下面四個警訊，出現任何一個，就先停下來查清楚。

這四個警訊，可以轉成四個問題。每次交辦工作之前，用這四個問題檢查你的規則和要求有沒有寫清楚；每次收到回報之後，再用同樣四個問題檢查結果。

六層架構講的是「怎麼管」，Explorer 讓你看到「管的是什麼」。Explorer 是一個互動網頁，它把 CM108G 這學期實際用到的工作區畫成十二站：從備課專案、個案、課程規格、教材原稿、課程網站、雲端硬碟的閱讀副本、Gemini Notebook，到 Teams、白板、互評平台、受限行政資料夾，以及最後一站「維護與交接」。

打開 Explorer 之後，先看三件事：

看的時候留意兩種東西：Agent「產生」檔案的線，和老師「核准」的閘門。Agent 產生的步驟可以越來越多、越來越快；老師的閘門則要放得剛好：太少容易出錯，太多會讓老師變成整條流程的瓶頸。

接下來五十五分鐘，你會讓一個 Agent 在一個資料夾裡做四輪工作。Claude 和 Codex 兩條路線做的事完全一樣，只有打開資料夾的方式不同。選你手上有的那一個。

先下載範本包，解壓縮到一個新的空資料夾。解壓縮之後，找到 course-ops-kit 這一層：打開後第一層就看得到 AGENTS.md、CLAUDE.md。Windows 的「全部解壓縮」常會多包一層以 zip 檔名命名的資料夾，請往裡面再點一層。兩條路線都要選 course-ops-kit 這一層，Agent 開工時才會自動讀到規則。

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

表中「屬於哪一層」寫「—」的，是被維護的教材與練習材料本身，不屬於六層裡的任何一層。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 裡從「教材原稿」到「雲端硬碟閱讀副本」的那一步，做的就是這件事。

第一輪不改任何檔案，只確認 Agent 讀到了規則與狀態。這一步看起來多餘，其實最重要：如果它一開始就讀錯，後面每一步都會跟著錯。

這一輪只讀，不要建立或修改任何檔案，也不要執行任何程式。
請先讀 AGENTS.md 和 HANDOFF.md，再看 00_core/status.json 和 02_requests/ 裡的檔案。
然後回答：
1. 用三句話說明這個資料夾在做什麼、目前的狀態、下一步是什麼。
2. 列出你讀到的規則中，最重要的三條，並說明為什麼。
3. 02_requests 裡的要求，依規則你可以做到哪一步、哪一步要停下來等老師？

第二輪交辦一件每週都會遇到的工作：處理 W03（第 3 週）的修改要求。這件工作要依序修改原稿、重建鏡像、更新狀態、執行檢查、寫交接紀錄，做完一次，等於把第 2 部的六層架構實際走過一遍。

先打開 02_requests/ 裡的要求看一眼。老師要求三件事：改寫一段例子、新增一題課後提問、在教師專用段落加一句提醒。第三件是特別設計的陷阱：教師專用的內容不能出現在鏡像裡，這句提醒如果寫錯位置，學生就會在筆記本裡讀到。要求裡那一句提醒，也用教師專用標記包起來了，check.py 會比對這一句有沒有跑進鏡像。

P2 的順序也有用意：重建鏡像之後，先把 W03 的狀態改成 draft（草稿），再執行 check.py。W03 原本是 approved（已核准），原稿一改，版本碼就變了；如果狀態沒有先改回 draft，check.py 會報「需要老師重新核定」。

請處理 02_requests/ 裡的 W03 修改要求，依 AGENTS.md 的規則進行：
1. 只修改 01_source/W03.md，其他週次與規則文件都不要動。
2. 執行 scripts/build_mirror.py W03 重建鏡像。Python 指令依序試 python3、python、py；三個都不能執行時，依 AGENTS.md 的人工方式處理，並在回報中說明。
3. 先更新 00_core/status.json：W03 的原稿與鏡像都改為「draft」，等老師核定。
4. 執行 scripts/check.py，把結果完整貼出來。有錯誤就依錯誤訊息處理；不可以修改 check.py、manifest.csv，也不可以手改鏡像。
5. 更新 HANDOFF.md。
這一輪不要產生學生講義。
完成後依 AGENTS.md 的回報格式回報：改了哪些檔案、檢查結果、還沒做的事、需要老師決定的事。

另外一個常見的錯誤訊息：check.py 報 W03「原稿改過……需要老師重新核定」。這代表 W03 的狀態還沒改成 draft，請它照 P2 第 3 步改，再執行一次 check.py。

第二輪的 Agent 說它做完了，檢查程式也通過了。但檢查程式只抓得到事先寫成程式的那幾種錯誤，所以第三輪請另一個 Agent 來審查。因為它沒有看過第二輪的過程，只看要求和結果，比較看得出「做了」和「做對了」之間的差距。

這一輪你負責審查 W03 的修改。修改是另一個工作階段做的，你沒有參與。這一輪只能讀檔案，唯一可以新增的檔案是 05_reviews/W03_審查.md。
請只讀：02_requests/ 裡的 W03 修改要求、01_source/W03.md、03_mirror/W03.md、00_core/course-spec.md、AGENTS.md。
逐項回答，並寫進審查紀錄：
1. 修改要求的每一項，原稿裡有沒有做到？引用原稿的句子當證據。
2. 鏡像裡有沒有出現教師專用的內容？
3. 新增的課後提問，學生只看鏡像的內容，答得出來嗎？如果答不出來，缺了什麼？
4. 有沒有超出要求範圍的修改？
5. 你建議老師核定，還是退回修改？理由是什麼？
不要修改原稿，也不要修改狀態。

P3 的第 3 題是審查最有價值的地方，因為它站在學生的位置檢查：學生只看鏡像，答得出新增的題目嗎？講師審 CM108G 的小考題目也用同樣的做法：寫題目的 Agent 和答題的 Agent 分開，答題的 Agent 有兩個，都只看得到題目和選項，看它們能不能說出這一題要學生判斷什麼。兩個答題的 Agent 都答不出來，或兩個選項都說得通，題目就退回重寫。

在 Claude Code 裡，也可以請主要的 Agent 另外派一個子 Agent 做審查。子 Agent 只讀檔案、做判斷，審查紀錄由主要的 Agent 寫進 05_reviews/。做法不同，原則一樣：審查的人不能是作者自己。

最後一輪，練習老師最重要的工作：設計閘門。閘門是規則裡的一個停止點，Agent 走到那裡必須停下來，等老師留下明確的核定，才能往下做。

這一輪要在第二輪完成、W03 原稿是 draft 之後才開始。第二輪沒做完，W03 原稿仍然有有效的核定，Agent 依規則可以產生講義，你就看不到閘門的作用。

範本包的 AGENTS.md 已經寫了誰能核定、核定行（HANDOFF.md 裡記錄老師核定的那一行）怎麼寫，還沒寫產生講義之前要檢查什麼。這一輪由你把這一條補上：W03 的學生講義，要等 HANDOFF.md 裡有一行核定才能產生；這一行要由老師親手寫，寫的版本碼也要和目前的原稿相同。

版本碼是 check.py 從檔案內容算出來的 8 個字元，印在它輸出的「版本碼」一節。原稿改過一個字，版本碼就不同，所以舊的核定不會被誤用在新的原稿上；同一天先核定、後修改，也查得出來。check.py 也會用版本碼檢查：狀態標成 approved 或 published 的檔案，HANDOFF.md 裡都要有對應、而且版本碼相同的核定行。

- 產生 04_handouts/ 的學生講義之前，先執行 check.py，從「版本碼」一節找到該週原稿目前的版本碼，再確認 HANDOFF.md 的「老師核定紀錄」裡有一行「核定：WNN 原稿 版本 xxxxxxxx」，而且版本碼和目前的相同。沒有這一行，就停下來回報「等待老師核定」，附上目前的版本碼，不要產生講義。
- 講義產生後，狀態一律標成 draft。發布給學生是另一個決定：要有版本碼和目前講義相同的「核定：WNN 講義發布」那一行，才能改成 published。

規則裡的 WNN 代表週次，例如 W03；xxxxxxxx 代表 8 個字元的版本碼。Agent 會換成實際的週次和版本碼去比對。

請執行 scripts/check.py，回報 status.json 裡 W03 原稿、鏡像、講義的狀態，以及 W03 原稿目前的版本碼。這一步不要修改任何檔案。

請依 AGENTS.md 的規則，產生 W03 的學生講義，存到 04_handouts/，並把 status.json 的 W03 講義標成 published。

我已經在 HANDOFF.md 留下 W03 原稿的核定。請重新讀 HANDOFF.md 與 AGENTS.md，依規則繼續，完成後依回報格式回報。

第二部分的測試提示詞故意要求了一件違反規則的事：把講義直接標成已發布。一個照規則做事的 Agent，第一次應該停在核定那一關；有了核定之後，它會產生講義，但仍然只標成草稿，並說明發布要由老師決定。如果它直接把講義標成已發布，就代表規則還有漏洞，回到第 1 步修改規則。

核定行少了版本碼、版本碼抄錯一碼，或寫在「老師核定紀錄」那一段的外面，都不算數；check.py 會在輸出的「錯誤」或「提醒」裡，告訴你是哪一行、差在哪裡。電腦沒有 Python 時，check.py 無法使用，也算不出版本碼，這一輪做到第 3 步，看 Agent 會不會停下來就好。

如果你手上沒有 Claude Pro，也還不能用 Codex，仍然可以用 ChatGPT 專案或 Claude 專案練習同一套流程。差別在於：網頁版的 ChatGPT 專案與 Claude 專案不能直接讀寫你電腦上的資料夾（ChatGPT 桌面版另有連結本機資料夾的專案，今天不使用），所以「動手」的那一部分要由你來做。你同時是架構師，也是搬運檔案的人：把檔案內容交給 AI，再把 AI 改好的內容存回電腦。完整的步驟與交辦文字，在範本包的 prompts/P5。

這樣做有兩個限制。第一，每一個檔案都要你手動搬，檔案一多就容易搬錯。第二，專案上傳的檔案是當時的複本，你改了電腦上的原稿，專案裡的版本不會跟著變，要刪掉重傳，而且重傳也算在每天的上傳數量裡。這兩個限制，也說明了 Claude Code 與 Codex 為什麼省事：它們直接在資料夾裡讀寫檔案，不需要你來回搬運。

但流程的設計一點都沒有少：規則、狀態、要求、檢查、審查、閘門都還在。今天先把設計做好，等你有了能讀寫資料夾的 Agent，同一套文件可以直接拿去用。

範本包裡的鏡像是 Markdown 檔（副檔名 .md 的純文字檔），放在你的資料夾裡；Gemini Notebook 從雲端硬碟同步的，是 Google 文件。從鏡像到筆記本的這最後一哩路，各人的做法不同。

講師的做法裡，有一個觀念可以帶回去用：雲端硬碟的檔案 ID 和筆記本的來源 ID 是兩個不同的編號。更新文件要用檔案 ID，要求筆記本同步要用來源 ID。CM108G 的維護資料夾有一份對照表，記錄每一週這兩個 ID、內容的雜湊值（由內容算出的一串編碼，內容一改就不同）、字數和最近一次同步的時間。Agent 每次更新後，都要讀回筆記本裡的內容，確認開頭文字對得上、教師專用的內容沒有出現，才算完成。

個人帳號的老師不需要做到這個程度。雲端硬碟的 Google 文件每隔幾分鐘就會自動同步到筆記本，用第一種做法貼上之後，打開筆記本問一個只有新版才答得出來的問題，就是最簡單的讀回確認。

動手做完四輪，你已經看過一條流程怎麼運作。接下來二十分鐘，換你設計自己的。設計之前，先看一份完整的示範：CM108G 每週更新一章教材的流程，用工作流程設計表寫出來。這份示範依 CM108G 的做法簡化，資料夾名稱換成範本包的。

這張表把流程拆成三段：輸入、處理、輸出。處理那一段最長，因為規則、例外、人工確認、老師核定和通知，都在這裡。這個三段的分法，來自講師在企業內訓中常用的小型 AI 工作流程做法。這種做法規模不大，但已經足夠讓一條流程實際運作，出了問題也查得到原因。

表中的 WNN 代表週次，例如 W03 是第 3 週；版本碼是 check.py 從原稿內容算出的 8 個字元。

這張表最容易寫空的是兩列：「例外」和「完成的證據」。例外寫不出來，代表還沒想過哪裡會出錯；證據寫不出來，代表將來只能聽 Agent 說「完成了」。

現在用同一張表，設計你自己課程的一條流程。選一條每週或每次都會重複、而且你現在最花時間的工作。範本包的 workflow 資料夾裡有一份設計表檔案，可以直接在上面寫。

寫完之後，和旁邊的老師交換，互看五分鐘。看別人的設計時，只找兩件事：

流程設計得再好，也要放回現實檢查一次。從三個面向看你剛才設計的流程：要花多少時間與費用、工具與權限準備好了沒有、誰來維護。

今天的內容可以濃縮成一句話：老師寫規則、狀態與要求，Agent 照著做並留下證據，另一個 Agent 審查，老師在閘門核定。工具會換，這套設計可以一直帶著走。

離開之前，選一個下週要做的起點。