入口

進階老師當架構師

跳到…
動畫版
列印

第 2 部・老師當架構師5 分鐘5 / 20

六層架構

六層架構:第 2 部動畫第 5 幕的畫面
在動畫版看這一段 ›第 2 部動畫・第 5 幕

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

六層架構與 CM108G 的對照
層 回答什麼問題 對應的檔案或做法 CM108G 的實際做法
1 規則 什麼可以做、什麼不能做?正式版本在哪裡? AGENTS.md(Claude 另用 CLAUDE.md 匯入它) 來源優先順序、逐字稿閘門、Quiz 發布閘門、寫作規則
2 狀態 現在做到哪裡?下一步是什麼? HANDOFF.md、狀態表 每一段工作結束時寫:做了什麼、檔案在哪裡、還沒做完的事、從哪裡接
3 能力 這類工作的標準做法是什麼? Skill(寫成檔案、讓 Agent 照著做的標準做法)、規格書 每週製作規格 v0.8 包成 Skill;動畫製作規格書 v1.1
4 執行 誰動手? Agent、子 Agent、程式 Codex、Claude;同時工作的兩個 Agent 共用一份一致性基準文件
5 驗證 怎麼證明做對了? 檢查程式、盲測審查、發布後從公開網址讀回內容 動畫檢查工具、Quiz 的盲測作答、發布後讀回網址,比對 SHA-256 雜湊值(由檔案內容算出的編碼)
6 閘門 哪一步一定要老師? 寫在規則裡的停止點 逐字稿要老師標成定稿;教材與題目由老師核准;發布前老師確認

前兩層是今天動手做的重點。規則放在 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,Claude 要在 CLAUDE.md 第一行匯入它;狀態放在 HANDOFF.md,並在規則裡寫明「開工先讀 HANDOFF.md」。
在 Explorer 看這一站第 01 站:備課專案

課程檔案系統 Explorer 把 CM108G 管理學這學期用到的檔案、工具與老師的決定,畫成一張十二站的地圖。按下按鈕,會在這一頁上方的視窗開啟。

Explorer

在新分頁開啟