語系變體圖 — 生成流程與教訓¶
姊妹檔：
concept-prompts.md（Stage 7.5 那 3 張概念圖的 ChatGPT prompt）。 這份記錄的是 2026-08-02 那批 5 張圖 × 3 語系 是怎麼產出來的，以及過程中踩到的坑。
這批處理了什麼¶
resources/diagrams/ 的慣例是 NAME.png = zh-TW、NAME.en.png、NAME.zh-Hans.png。
處理前有 5 張圖缺 9 個變體，導致 .en.md / .zh-Hans.md 頁面alt text 已在地化、圖檔還是繁中。
| 圖 | 結果 |
|---|---|
multi-llm-delegation-composition |
補上 .zh-Hans，忠實比照既有的 .png / .en.png（深色霓虹＋廠商 logo） |
teacher-ai-use-cases-overview |
三語重產，升級為 house style（彩色卡片＋線條 icon） |
teacher-ai-classroom-use-cases |
三語重產，升級為 house style（五欄卡片式） |
rag-pipeline-overview |
三語重產，淺色卡片流程圖（未達 house style，見下方） |
chunking-strategies |
三語重產，淺色卡片流程圖（未達 house style，見下方） |
副檔名同時從 .jpg 改為 .png（house style 那 20 張都是 png，線條插圖＋密集文字用 jpeg 會有壓縮雜訊），
stages/06-memory-rag 與 branches/for-teacher 共 12 處引用一併更新。
生成方式¶
委派 Codex CLI 的內建 image-gen 工具，不是貼 prompt 到 ChatGPT 網頁。流程：
- 寫 brief 到
.ai/codex_task_<NN>_<slug>.md（.ai/已 gitignore） bash ~/.claude/skills/codex-delegate/scripts/run_codex.sh --brief-file <path> --repo "$PWD"- brief 裡指定 repo 內的既有圖當風格參考（Codex 能直接讀圖檔），並附完整逐字文字表
- 委派者自己逐張開圖驗收，不採信
.result.json的 status
風格基準檔：stack-4layer.zh-Hans.png、agent-guardrail-patterns.zh-Hans.png、
teacher-ai-use-cases-overview.png（本批做得最好的一張，可當樣板）。
⚠️ 驗收教訓（這批最值得記的部分）¶
1. delegate 回報 success 不等於做對了 —— 這批四次假成功¶
| 事件 | 實際狀況 |
|---|---|
chunking-strategies.zh-Hans 第 1 次 |
殘留繁體 種 / 純，回報 success |
| 同上第 2 次 | 修好 純→纯，種 仍是繁體，又回報 success |
| rag/chunking house style 第 3 次 | 修好乾淨度但整個丟掉 house style |
| 同上第 4 次 | 根本沒改寫檔案（時間戳未變），卻列出一串「已執行的驗證指令」 |
驗收必須是委派者自己看原始產出，而且要有能分辨的方法。
2. CJK 繁簡差異在縮圖尺寸下看不出來¶
種/种、純/纯 只差一個部件。可靠做法：
- 把有疑慮的文字區塊裁切放大 3–4 倍
- 拿 repo 裡已知正確的同一個字當對照
- 分辨重點在偏旁：
种=禾+中、種=禾+重；纯=纟、純=糸
3. 長寬比是客觀的風格對齊指標¶
肉眼判斷「風格像不像」不可靠。量長寬比可以抓出版面鬆緊度的偏移——
本批就是這樣抓到 rag-pipeline 變體被拉鬆（繁中 3.20、.en 2.86、.zh-Hans 2.40）。
現在五組圖三語長寬比差異都 < 0.05。
4. 「改圖」比「重新生成」更容易失控¶
要求 Codex 修改既有圖時，它兩次都超出範圍（擅自重新設計節點、改名）， 還引入新缺陷（標籤壓框、文字被形狀邊緣裁切）。 指定重新生成、並附完整規格，比叫它「只修這兩點」可靠。
已知未竟事項¶
rag-pipeline-overview 與 chunking-strategies 這兩組（共 6 張）視覺等級不如 teacher 兩組——
是乾淨、文字正確、三語一致的淺色卡片流程圖，但沒有線條 icon、配色也弱。
四次嘗試都在「有 house style 但有瑕疵」與「乾淨但退回素面」之間擺盪。
要再挑戰的話，建議：
- 以 teacher-ai-use-cases-overview.png 為唯一視覺樣板，把它的構圖元素逐項拆解寫進 brief
- 或改用 --model 指定不同模型重試
- 原始 .jpg（2026-05 版）仍在 git 歷史中，必要時可還原
重產時的檢查¶
python scripts/check-image-locale.py
該 gate 把「同語系變體已存在但頁面沒用」當錯誤直接擋，「變體還沒做」則記在它的
KNOWN_MISSING 白名單裡——所以新增一張缺變體的圖會讓 build 失敗，不會默默累積。
補完變體後記得把對應的 KNOWN_MISSING 條目一起移除。