第二輪交辦一件每週都會遇到的工作:處理 W03(第 3 週)的修改要求。這件工作要依序修改原稿、重建鏡像、更新狀態、執行檢查、寫交接紀錄,做完一次,等於把第 2 部的六層架構實際走過一遍。
先打開 02_requests/ 裡的要求看一眼。老師要求三件事:改寫一段例子、新增一題課後提問、在教師專用段落加一句提醒。第三件是特別設計的陷阱:教師專用的內容不能出現在鏡像裡,這句提醒如果寫錯位置,學生就會在筆記本裡讀到。要求裡那一句提醒,也用教師專用標記包起來了,check.py 會比對這一句有沒有跑進鏡像。
P2 的順序也有用意:重建鏡像之後,先把 W03 的狀態改成 draft(草稿),再執行 check.py。W03 原本是 approved(已核准),原稿一改,版本碼就變了;如果狀態沒有先改回 draft,check.py 會報「需要老師重新核定」。
P2 交辦每週任務(範本包 prompts/P2)
請處理 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 的回報格式回報:改了哪些檔案、檢查結果、還沒做的事、需要老師決定的事。
收到回報後,用四個問題檢查
- 誰可以改什麼? 回報列出的檔案,是不是只有 W03 原稿、W03 鏡像、manifest.csv、status.json 和 HANDOFF.md?打開 W01、W02 確認沒被動過;scripts/ 裡也不應該多出任何檔案。
- 做完怎麼證明? check.py 的結果有沒有貼出來?錯誤是不是 0?打開 03_mirror/W03.md,搜尋要求裡那句教學提醒(例如搜尋「先付款」),應該找不到。
- 哪一步一定要我? status.json 的 W03 原稿與鏡像是不是「draft」?它有沒有自己改成「approved」?
- 下一個人從哪裡接? HANDOFF.md 有沒有寫這一段做了什麼、還沒做的事、等老師決定的事?「老師核定紀錄」那一段有沒有被動過?
示範常見的三種結果
一次就對:回報清楚,check.py 錯誤 0,W03 停在 draft。這代表規則寫得夠清楚。
做對了,但回報不完整:檔案都對,但沒有貼 check.py 的結果。到 AGENTS.md 的「回報格式」那一段,把「完整貼出 check.py 的輸出」寫得更明確。
做錯了:常見的有兩種。第一種是把教學提醒寫在教師專用標記的外面。check.py 會比對修改要求裡標成教師專用的那一句,所以抓得到;如果寫錯位置的是別的內容,就要靠你搜尋鏡像,或等第三輪的審查。第二種是順手改了 W02 的錯字。W02 的版本碼會因此改變,check.py 會報 W02 需要老師重新核定,但這個修改該不該做,要靠你檢查範圍才知道。兩種情況都要在規則裡加一條,並請它把改錯的地方還原。
另外一個常見的錯誤訊息:check.py 報 W03「原稿改過……需要老師重新核定」。這代表 W03 的狀態還沒改成 draft,請它照 P2 第 3 步改,再執行一次 check.py。
本頁收穫
- 一件每週任務要依序修改原稿、重建鏡像、更新狀態、執行檢查、寫交接紀錄,每一步都要留下證據。
- 用四個問題檢查回報;發現漏洞,就把它變成 AGENTS.md 的一條規則。
