論述基礎與限制

本卡抽自 macOS Preboot 卷文章的重寫。初版以「三層檢查方法 + 異常指標表格」為主線，寫成排查手冊；重寫後改以「Preboot 在開機流程的角色 → Cryptex 機制 → Intel vs Apple Silicon 差異」為主線，檢查方法變成理解機制後的自然推導。觸發重寫的判斷是：初版的結構讓讀者依賴查表，重寫後讀者理解 Cryptex 的 os.dmg 本身就要 5.4G，任何大小都能自己判斷。限制：本卡的 case 集中在操作型文章（系統管理、工具使用），教學模組和抽象原則類文章的結構選擇可能有不同的考量。

核心原則

技術文章寫完後，讀者帶走的應該是鑑別能力——面對這個領域的新情境，他能自己評估、自己判斷，而不是回來查文章裡的步驟或表格。操作流程和語法參數是鑑別能力的副產品，讀者有了判斷力自然知道該查什麼指令，但反過來不成立——背了指令的人遇到變體情境仍然卡住。

文章的知識目標決定結構。判斷力導向的文章把機制理解當主線（為什麼這個機制存在、它解什麼問題、它的設計取捨是什麼），操作方法從機制裡自然推導出來，放在後段或獨立篇章。流程導向的文章把步驟當主線，機制變成步驟之間的解釋插入。兩者都能寫得好，差別在讀者讀完後的狀態：一個帶走判斷力，一個帶走一份可執行的 checklist。

這次的情境

一篇介紹 macOS Preboot 卷空間佔用的文章，初版的結構：

  1. 第一層：確認實際大小（指令 + 門檻值）
  2. 第二層：檢查內部結構（指令 + 正常特徵列表）
  3. 第三層：排除舊安裝殘留（指令 + 判斷方式）
  4. 異常指標表格（指標 → 意義 → 處理）
  5. 不該做的事

這是典型的流程導向結構——讀者照著三層走、對著表格查、記住禁忌。能解決「Preboot 是不是正常」這個特定問題，但讀者讀完後仍然不知道 Preboot 為什麼從 1G 變成 8G。下次遇到 12G 的 Preboot 或完全不同的 APFS 卷異常時，他沒有足夠的知識自己判斷，要回來查文章或另外找資料。

重寫後的結構：

  1. Preboot 在開機流程中的角色（為什麼需要一個獨立卷放開機前置資料）
  2. Intel Mac 的 Preboot（1-2G 的經驗從哪來）
  3. Apple Silicon 的 Cryptex（為什麼大小結構改變了、os.dmg 5.4G 的來源）
  4. restore-staged 的更新暫存機制
  5. du 跟 diskutil 數字不一致的技術原因（APFS clone）
  6. 什麼情況才真的有問題（從機制自然推導出來的結構性指標）

讀者讀完第 3 段就知道「8G 是因為 Cryptex」，不需要查表。第 6 段的異常判讀從機制裡推導出來——多個 Volume Group UUID 意味著多組 Cryptex，所以 Preboot 翻倍——而不是一條記住就好的規則。

理想做法

寫技術文章時，先釐清讀者讀完後該處於什麼狀態：

判斷力導向：讀者理解了某個領域的運作機制，遇到這個領域的問題能自己評估處理方式。文章主線是機制、設計取捨、各元件的責任邊界。操作指令和參數是附帶的，可以放在段落裡、也可以拆成獨立的操作參考篇。

流程導向：讀者拿到一份可執行的步驟，照做能解決特定問題。文章主線是步驟順序、前置條件、預期結果。適合已經有判斷力、只是需要具體指令的讀者，或者情境單一、不太需要判斷的操作（例如安裝設定）。

多數教學文章應該走判斷力導向。流程導向適合的場景比直覺中少——讀者如果只需要步驟，通常去查官方文件比讀文章快。文章的價值在於提供判斷力，這是官方文件不做的事。

跟其他原則的關係

  • #210 壓縮結論剝奪推導路徑：知識目標是判斷力時，傳遞方式自然會展開推導過程。知識目標是流程時，容易落入威脅/命令/教訓式的壓縮傳遞——因為 #209 選了判斷力作為目標，#210 的展開推導才有了錨點。
  • #211 複合問題先拆機制再談交互：判斷力導向的文章在面對多概念交互時的展開結構。先由 #209 確認主線是機制理解，再用 #211 的拆分原則決定多個機制如何各自成篇。
  • #170 Description 是 recall trigger：description 的功能建立在文章有明確的知識目標上。判斷力導向的文章，description 寫「什麼情境下需要這份判斷力」；流程導向的文章，description 寫「什麼情境下需要這份操作步驟」。
  • #166 重點優先陳述是跨語言的資訊結構原則：判斷力導向的文章天然符合核心先行——機制理解本身就是核心，操作步驟是衍生。
  • AGENTS.md 原則三「商業邏輯先於 CASE」：機制先於操作是同一個原則在不同粒度的體現。

判讀徵兆

寫完一篇文章後，用這個問題檢查知識目標是否達成：「讀者讀完後，遇到一個文章沒提到的同領域變體問題，他能自己判斷怎麼處理嗎？」如果答案是否，文章可能在教操作而不是在教判斷。