本 repo 首版是抽象教學與題庫。預設學習模式只讀被指定章節的正文、設計取捨與題目,先要求讀者自答;除非讀者要求提示或參考解答,不主動開 hints.md、solutions.md。這是教學協作約定,不是檔案安全邊界。
使用者交辦教材維護時可進入作者模式,維護正文、提示、解答、圖說與來源。只有明確安排後續實作時,才建立 lab 程式與環境;目前各 lab 是規格,不能宣稱已跑通。
使用繁體中文,保留英文技術名詞。每章說清楚責任、取捨、失敗與驗收,允許不同合理答案。合成案例明確標示,不能冒充真實執行證據;設計、實作、測試與部署狀態分開。
OpenAI 產品能力優先查官方目前文件;規格、研究與工程經驗分別標記。訂閱 OAuth+Responses 是有資格、授權與能力限制的 preview,不能假設所有 Responses 參數與 hosted tools 可用。生圖是教材製作流程,不代表該推論路線支援 hosted image generation。
章節、題目與 assets 留在對應主題/章節。個人答案放 .study/,可變 lab 狀態放該 lab/.local/。不讀取、複製或提交真實登入憑證,不修改使用者全域 Codex 設定。
維護後檢查相對連結、錨點、章號/題號、來源與圖片;更動章節位置時同步所有索引。資料夾隔離不當成 sandbox 證據。
章首以具體情境與選擇帶入,名詞在需要時才解釋。核心主線一次推進一個判斷,以短段落串起資料、理由與下一步;完整欄位、長表與次要規格留深挖,保留技術正確性及可回查來源。
安排少量與機制相關的微判斷及自然斷點,提供停下後可接讀的線索。配套題目一次交代一個步驟,Codex 一次只追問一件事。保持成人語氣,不幼兒化,不把特定診斷當單一閱讀習慣,也不宣稱閱讀方式有醫療效果。