一個根本性的誤解

我們花了很長時間，把方法論文件寫得越來越完整——完整的定義、詳細的範例、細緻的流程說明，直到有一天發現，這樣的文件根本沒有人在用。

問題出在誤解了方法論的讀者是誰。

方法論的讀者是專家。他們已經知道這些內容，只是需要時忘記了細節。他們不需要被教導，只需要一個快速的提醒，幫他們找回記憶。

30 秒電梯理論

我們現在用一個簡單標準評估方法論：能在 30 秒內讀完嗎？如果不能，就太長了。

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

方法論與 SKILL 的分工

方法論是複習清單：告訴你「有哪些原則」「判斷方向是什麼」，讓你快速確認沒有遺漏重要考量。

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

過去把兩者混在一起，結果兩頭不討好——方法論太長難以快速查閱，又因試圖簡潔而省略了真正需要的操作細節。

撰寫方法論的核查

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

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

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

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

消除歧義仍然是核心要求

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

簡短但模糊的方法論比詳細但模糊的更糟糕——它讓讀者覺得已經複習完了，卻什麼都沒想清楚。