# CM108G Become Judy 教科書專案工作規範

## 專案目的

本專案建立 CM108G《Become Judy》18 週英文教科書。每週單元是獨立、可閱讀、可測試的 HTML 教科書頁面；每一單元的 `main_body` 必須至少 5,000 個學生實際看得到的英文單字。Markdown 連結只計標籤、不計網址，HTML 標記／註解與 glossary、assessment、references、介面文字均不計，連字號複合詞算一字；Writer 以 5,100 個可見字作為安全目標。教材以提供的《新經營學》參考書為主要概念基底，以 Become Judy 公開案例作為主要教學情境，並以管理學研究與權威機構資料進行校準。

本專案不是參考書翻譯，也不是把案例資料全部當成事實。所有案例敘述必須遵守 Case Bible 的證據分級，將 confirmed fact、researcher inference、fictional-composite teaching scenario 與 unknown 清楚分開。

## 正式根目錄與來源邊界

- 正式根目錄：`G:\GoogleDrive\CourseWorkspace\YZU\Management 管理學\1151\Textbook`
- `G:\GoogleDrive\CodexWorkspaces\CourseWorkspace\YZU` 僅為工作區，不是正式輸出位置。
- 參考書快照放在 `01_sources/reference-book/`，不可複製大段原文到學生頁面。
- 每個單元的 learner-facing resources 必須說明授課教師受到 Koji Mitani（三谷宏治）2019 年 *すべての働く人のための新しい経営学* [*A new management theory for everyone who works*, editorial translation] 啟發，簡述經官方來源確認的作者背景與該書以 Target、Value、Capability、Revenue Model 組織管理思考的特色，並說明其餘教材來自教師提供資料及單元專屬的理論、證據、應用與實務分析。教材不是翻譯、續編、官方英文版或參考書替代品；學生頁面不得顯示所提供 Google 文件網址。
- Become Judy 原始案例位於 `G:\GoogleDrive\CourseWorkspace\Biz Daily\HBR Taiwan\Become Judy`；本專案只保存必要 metadata、證據索引與經查核的教學轉化，不覆寫原案例專案。
- 學生背景只可使用去識別化的國別統計來設計多元情境，不得把學生姓名、學號、email 或可識別資料放入教材。

## Agent 治理

本專案由一個持續存在的 Chief PM 統合；Chief PM 之外同時最多三個工作 Agent：Research、Writing and Learning Design、Strict Review。任何 Agent 開工前必須先讀取控制塔、Case Bible、claim ledger、timeline、所有已 reviewer-cleared 單元的 review passport 與 final review decision。第一次進入專案、passport/hash 失效或 impact trigger 觸發時，才對必要前文依 context manifest 分段全文閱讀；未變更內容可用 passport、SHA-256 與 targeted sample 接手，不得以摘要假裝完成對變更內容的閱讀。

所有新工作 Agent 使用 `gpt-5.6-luna` 與該模型在目前 runtime 可執行的最高 reasoning effort（目前為 `max`，對應本次指定的「超高」）。不得靜默改用其他模型或較低推理等級。

每個 Agent 必須留下 `context_readback.md`、`work_report.md`、`source_changes.md`、`unresolved_questions.md`、`claim_updates.csv`、`terminology_updates.md` 與 `next_agent_instructions.md`；Strict Reviewer 另須留下 rapid gate、focused review、final review 與 review passport 證據。Chief PM 必須檢查 readback，發現把推論當事實、遺漏變更依賴或誤解案例時退回任務。

`reviewer-cleared` 只代表研究、寫作與 Strict Review 完成，允許下游單元閱讀；`instructor-approved` 才代表教師完成審核。未經教師明確授權，不 commit、push、部署、發布或改變外部權限。

Strict Review 採 `00_admin/REVIEW_EFFICIENCY_PROTOCOL.md` 的 Rapid Gate → Focused Review → Final Review 流程。`rapid-gate-passed` 與 `provisional-pass` 只代表沒有立即二元 blocker，不能取代 `reviewer-cleared`；已通過內容只有在 Case Bible、來源、術語、模板、依賴或 canonical hash 變更時才依 impact map 重新深審。

## 來源優先順序

教師最新明確指示 > 可驗證原始來源 > 最新核准版 Case Bible > reviewer-cleared 教材 > 待審研究、媒體轉述與作者推論。衝突無法解決時建立 `00_admin/DECISIONS.md` 待裁決事項並將受影響單元標記為 blocked，不由 Writer 自行選擇。

研究優先採真正與主題相關的 Top Tier journals、官方統計與權威公共資料；Accenture、McKinsey、BCG 等報告只能在記錄樣本、地區、方法、年份、企業立場與限制後使用，不能取代學術因果證據。YouTube 僅在記錄 channel、video ID、日期、timestamp、transcript 與翻譯狀態後使用；未人工校對字幕不得使用精確引號或未核對數字。

## 內容與 HTML 規則

- 正文英文；必要時可補充學生母語術語，但不以語言差異推測學生能力或人格。
- 每單元具備學習地圖、No AI 任務、最多 15 個 glossary terms、三題 AACSB-aligned assessment、表格、SVG concept architecture、APA 7 references 與可追溯快捷連結。
- 主要閱讀正文採單欄；桌面版可保留左側章節導覽，但不得以多欄切割長篇正文。至少 XS、S、M、L、XL 五檔字級控制。
- 閱讀頁需提供選取文字後的 Highlight、Underline、Add note、My notes、Return to text、Delete、Print 與 Markdown/JSON/marked-HTML/plain-text export。標註只留在目前瀏覽器的 localStorage，不上傳課程網站；每個狀態與下載結果都要接受瀏覽器、手機版、鍵盤與列印 QA。
- SVG 必須有 `viewBox`、`role="img"`、`aria-label`，短標籤、少交叉線，並搭配文字或表格說明。
- Learner-facing HTML 不得顯示 Chief PM、Agent、Context Packet、Claim Ledger、私人路徑、內部 status、學生個資或未完成研究筆記。

## English prose and anti-AI-voice review

英文教材必須另外通過 `avoid-ai-writing` skill 的英文稿審查。此要求不是要把教材改成口語貼文，也不是用關鍵字掃描代替編輯判斷；目標是讓正式教材有具體觀察、自然節奏、清楚的作者判斷與足夠的論證連接，避免生成式文字常見的制式開場、空泛誇飾、虛假平衡、同義詞輪替、過度三項排比、密集小標、機械式段落長度、聊天機器人客套語與未命名的模糊歸因。

每個英文單元至少執行兩次：Writer 交稿前作 rewrite-mode self-audit；Strict Reviewer 以 `blog`/long-form textbook 的嚴格標準進行 detect-mode 審查，對確定問題退回修改，並在必要時直接改寫受影響段落。Reviewer 必須保留學術精確性、限定語與來源支持的因果邊界，不得為了「像人」而刪除必要的 uncertainty。報告需記錄 em dash、AI-ism 詞彙、模板句、結構規律、段落節奏、模糊歸因、宣傳語氣與過度中立等檢查結果；無法證明已完成時，不得標記 `reviewer-cleared`。

## 驗收與交接

每個階段完成後更新根目錄 `HANDOFF.md`、`PM_CONTROL_TOWER.md` 與 `pm_state.json`。測試至少包含英文正文 word count、claim-to-source 追溯、APA/URL、HTML heading/anchor/link、mobile overflow、五檔字級、SVG XML/accessibility、privacy scan 與中斷後 handoff readback。只有 18 單元、研究、Review、教師核准、版面與回歸測試全部成立時，才可標示專案完成。
