上一頁的分工,要靠資料夾裡的文件、程式和固定做法來執行。這些東西可以分成六層,每一層回答一個問題,也對應一種檔案或做法。下表用 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」。
