教材給技術理由、不替方案下品質評價
論述基礎與限制
本卡的建卡判準是教學需求、不是出現頻率（對應 AGENTS 知識卡片規範段：建卡看「讀者缺這個知識會不會難以理解教材」、出現頻率只是補充訊號）。具體限制：
- 觸發 case 只有 1 個實例：這次 review 的 HOF 文章只出現一處「教科書級」。建卡的正當性來自「自評誇飾在技術寫作裡是常見 pattern」這個教學需求、不是這篇的頻率。單篇頻率低不影響值得建卡。
- 誇飾詞是 starting set、不是窮舉：列出的（教科書級 / 堪稱 / 完美 / 漂亮地）是觀察到的、不代表完整詞庫。新誇飾（神級 / 教科書式 / 無懈可擊）出現時持續擴充。
- 跟 #111 誇張家族部分重疊：本卡跟 #111 同屬「誇飾」大類、靠「評價對象」區分（見關係段）。邊界可能在某些句子模糊、需個案判斷。
核心原則
教材的責任是給出「為什麼這樣設計 / 為什麼適配」的技術理由，不對方案下品質評價。 自評誇飾（「X 是教科書級的適配」「堪稱經典」「完美契合」）讀起來像作者在替自己的方案打分數 —— 它傳遞的是作者的滿意度、不是讀者能用的概念。
更深的問題是品質評價會頂替技術理由：寫了「X 是教科書級的適配」、就佔掉了本該寫「X 為什麼適配」的位置。讀者拿到一個 verdict（這方案很好）、但拿不到 reasoning（好在哪、適配條件是什麼、邊界在哪）。誇飾是「評價空降」—— 給結論不給依據。
| 自評誇飾 | 讀者拿到的 | 該換成的技術理由 |
|---|---|---|
| 「X 是教科書級的適配」 | 作者覺得很適配 | X 對上的具體結構（固定流程寫死、變化點抽參數） |
| 「堪稱經典的設計」 | 作者覺得很經典 | 這設計解決的具體問題 + 成立條件 |
| 「完美契合不可變模型」 | 作者覺得很契合 | 契合的機制（更新本質是 current → next、函式參數正好表達） |
| 「漂亮地解決了 X」 | 作者覺得很漂亮 | 解法的步驟 + 為什麼這樣最省 |
具體 case
誇飾版：「當『共用流程』與『變化點』能這樣切乾淨時，HOF 是教科書級的適配：把固定流程寫死在 update 裡，把變化點抽成函式參數 transform 由呼叫端帶入。」
問題：
- 「教科書級」是品質評價、不是技術內容 —— 讀者無法反推「適配到什麼程度、什麼條件下成立、邊界在哪」。
- 它頂替了理由的位置：冒號後面的「把固定流程寫死、把變化點抽成參數」其實才是真正的適配理由、但被「教科書級」這個 verdict 搶了焦點。
- 沒有教學會說某寫法是「教科書寫法」—— 這句話的語氣是個人檢討在誇方案、不是教材在講概念。
修法版：「當『共用流程』與『變化點』能這樣切乾淨時，HOF 正好對上這個結構：把固定流程寫死在 update 裡，把變化點抽成函式參數 transform 由呼叫端帶入。」
差別：「正好對上這個結構」是中性的適配陳述、把焦點交給冒號後面的具體機制；「教科書級」是 verdict、把焦點留在作者的評價上。
沒這樣做的麻煩
讀者拿到 verdict、拿不到可遷移的判準
「教科書級的適配」讀完、讀者只知道「作者覺得這很適配」、無法判斷自己的 case 適不適配。教學的目的是讓讀者拿到能套用到新情境的 reasoning —— 品質評價給不了這個。這違反 AGENTS 原則七（每段要有可操作判準、不能只做評價）。
評價會掩蓋「理由其實沒寫」
誇飾讀起來很有說服力、容易讓作者跟 reviewer 都以為「這段講清楚了」。實際上 verdict 佔了版面、理由可能根本沒展開 —— 跟 #94 的空降斷言同構：包裝成肯定句、但依據是空的。
語氣從教材滑向個人檢討
「教科書級 / 堪稱經典」是回顧視角的自我評價（我這方案選得好）。教材是面向讀者講概念、不是面向自己總結成果 —— 語氣一滑、整段的 register 就從「教學」變成「炫耀 / 自評」。
跟其他抽象層原則的關係
- #111 口語化修辭會稀釋技術精度：兩卡同屬「誇飾」大類、靠評價對象區分。#111 的誇飾誇張的是技術屬性（「一輩子」誇張時間、「整個炸了」誇張嚴重度）—— 是對技術事實的不精確描述。本卡的誇飾評價的是方案品質（「教科書級」評價設計好壞）—— 根本不在描述技術事實、是 verdict 頂替 reasoning。#111 修法是「翻譯回技術屬性」、本卡修法是「換成技術理由」。
- #150 教材用中性陳述、不對讀者喊話：兩卡是 register/stance 議題的 sibling。#150 的違反是「管理讀者」（安撫 / 代入 / 指揮）、本卡的違反是「評價方案」（替自己的設計打分數）。兩者都背離「教材中性陳述概念」這個上層 stance、但對象不同（讀者 vs 方案）。
- #94 正向改寫要保留對照論據、不能空降結論：本卡是 #94「空降斷言」在「品質評價」維度的變體。#94 處理「刪掉對照 Y → 結論 X 變空降」、本卡處理「誇飾 verdict 頂替理由 → 評價變空降」。兩者共享同一個失敗：給結論不給依據、讀者只能選擇相信或腦補。
- AGENTS 原則七（每段要有可操作判準）：誇飾直接違反原則七 —— verdict 不是判準。本卡是原則七在「自評誇飾」這個具體違反形式上的展開。
判讀徵兆
| 徵兆 | 該做的行動 |
|---|---|
| 出現「教科書級 / 堪稱 / 完美 / 經典 / 漂亮地 / 優雅地」 | 自評誇飾 —— 換成具體技術理由 / 機制 |
| 句子在說「這方案有多好」而非「這方案怎麼運作 / 為什麼成立」 | verdict 頂替 reasoning —— 補回理由 |
| 刪掉誇飾詞後、該段的適配理由仍完整 | 誇飾是純贅字 —— 直接刪 |
| 刪掉誇飾詞後、該段只剩 verdict、沒有理由 | 理由根本沒寫 —— 補機制 / 條件、不是補誇飾 |
| 語氣像在總結「我選得好」而非對讀者講概念 | register 滑向個人檢討 —— 改回中性陳述 |
適用範圍與邊界
- 適用：概念建立段、設計理由段、適配性論述 —— 這些地方該給機制 / 條件、不該給品質評價。
- 不適用：純 narrative / 復盤型內容（work-log 的事件回顧、retrospective）—— 這類內容本就含作者視角的評價、誇飾是合理 register。
- 邊界：中性化 ≠ 禁止一切「適配 / 適合」字眼。判別線是「這句給的是可遷移的判讀條件（三條件齊備時 HOF 比列舉更省）還是品質 verdict（教科書級）」—— 前者是判準該留、後者是評價該換。帶條件的適配陳述不是誇飾。
Self-case：本卡的觸發來源
本卡觸發於 review 為什麼這個場景適合用高階函式 時、讀者指出「HOF 是教科書級的適配」這句 —— 「這比較像個人檢討、沒有教學會說這是教科書寫法」。
關鍵判讀：這句精度沒問題（HOF 確實適配這個結構）、grep 也不一定命中（「教科書級」不在口語修辭 keyword bank）、但 register 錯了 —— 它在評價方案品質、不在陳述技術理由。修法是把「教科書級的適配」換成「正好對上這個結構」、讓焦點回到冒號後面的具體機制。
建卡的正當性來自教學需求、不是這篇的頻率：自評誇飾在技術寫作裡是常見 pattern、讀者 / 作者都容易把「verdict 讀起來有說服力」誤當「理由講清楚了」。這篇只有 1 個實例、但 pattern 普遍 —— 對應 AGENTS 知識卡片規範段「建卡看教學需求、出現頻率只是補充訊號」。