入口

進階老師當架構師

跳到…
動畫版
列印

第 1 部・第 5 週之後4 分鐘1 / 20

今天兩小時的路線與準備

今天兩小時的路線與準備:第 1 部動畫第 3 幕的畫面
在動畫版看這一段 ›第 1 部動畫・第 3 幕

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

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

今天的時間安排
時間 做什麼 你手上會留下
0–11 分鐘 一學期的維護量;一次對話做完為什麼會出事 三個出事的狀況,以及它們缺的三樣東西
11–30 分鐘 架構師、指揮與動手的人;六層架構;AGENTS.md 與 HANDOFF.md;四個警訊;用 Explorer 互動網頁看一門課的十二站 六層架構的對照表、四個警訊
30–85 分鐘 依序動手做四輪:只讀不改、交辦每週任務、另開一個 Agent 審查、把閘門寫進規則 一個能運作的課程維護資料夾
85–105 分鐘 用工作流程設計表設計自己課程的一條流程,再和旁邊的老師互看 一份自己課程的流程設計表
105–120 分鐘 從時間與費用、工具與權限、人三個面向回頭檢查 下週要做的第一件事

上課前請準備(擇一條路線)

  • Claude 路線:使用 Claude 桌面版(Windows 或 macOS)裡的「Code」分頁,也就是 Claude Code。需要 Pro 以上方案;免費方案沒有 Claude Code。Windows 不需要安裝 Git(程式設計常用的版本管理工具);如果桌面版要求安裝 Git,先把桌面版更新到最新版本。
  • Codex 路線:使用 ChatGPT 桌面版裡的 Codex,或在終端機(輸入文字指令的視窗)使用 Codex CLI。ChatGPT 桌面版在 macOS 只支援 Apple Silicon 的 Mac。Plus 以上方案確定可用;免費方案依官方說明正在逐步開放,請先打開桌面版,確認看得到 Codex。
  • 兩條都沒有:可以用 ChatGPT 專案或 Claude 專案練習「人工指揮」的版本:AI 改好內容交給你,由你自己存回電腦裡的檔案(做法在第 3 部「沒有付費方案時」那一頁)。這樣比較費工,但流程的設計一樣能練習。
  • 確認電腦有 Python 3:範本包裡的檢查程式要用 Python 執行。Windows 在「命令提示字元」輸入 py --version,macOS 在「終端機」輸入 python3 --version,看到 Python 3 開頭的版本號就可以。沒有 Python 也能上課:Agent 執行不了範本包的程式,會照範本包規則檔 AGENTS.md 寫好的步驟手動完成;檢查程式 check.py 也不能用,檢查改靠第三輪的審查。
  • 本課的範本包:一個已經放好規則、示範教材和檢查程式的練習資料夾,壓縮成 zip 檔。下載連結在第 3 部第一頁,標題是「開始前:選一條路線」。下載後解壓縮到一個新的空資料夾。Agent 會讀寫這個資料夾裡的檔案,請不要解壓縮到放有重要資料的地方。

本頁收穫

  • 進階課處理一整學期的課程維護:老師當架構師,用規則、狀態、要求三份文件指揮 Agent。
  • 先選一條路線:Claude(Pro 以上)或 Codex;都沒有時,用專案練習流程設計。