方法論的讀者已經知道內容

方法論文件越寫越完整——完整的定義、詳細的範例、細緻的流程說明——而在任務中途沒有人打開它時，落差在讀者設定上。

方法論的讀者是已經知道這些內容的人，缺的是當下想不起來的那個細節。他們要的是一次快速的提醒，而完整的教學文件在那個時刻讀不完。

30 秒是長度上限

方法論的長度用一個標準評估：能不能在 30 秒內讀完。超過就太長。

讀者打開方法論通常是在任務中途，需要確認某個原則或步驟。超出 30 秒的內容搬移到獨立的 SKILL 文件，由方法論引用。

方法論與 SKILL 的分工

方法論是複習清單：列出有哪些原則、判斷方向是什麼，用途是快速確認沒有遺漏重要考量。

SKILL 是實作指南：包含範例、錯誤處理、邊界情況，回答具體怎麼做。

兩者混在一起的結果是兩邊都不成立——方法論長到無法快速查閱，又因為要控制長度而省略了操作時真正需要的細節。

撰寫方法論的核查

每次撰寫或改寫方法論，問三個問題：

有完整的操作流程嗎？建立對應 SKILL，方法論只保留原則和引用。

有程式碼範例或錯誤處理細節嗎？屬於 SKILL，不屬於方法論。

精簡後會流失關鍵資訊嗎？如果是，那些資訊本來就不屬於方法論。

消除歧義仍然是核心要求

精簡不代表模糊。「應該」改為「必須」，「建議」改為「要求」，「適當時機」改為具體時間點。每個判斷只有兩種結果：接受或拒絕、必須或禁止。

簡短而模糊的方法論比詳細而模糊的更危險：它讀得完，於是複習的動作看起來完成了，而該被確認的判斷一個都沒被確認。