做 AI coding 一年多，前後六七個專案，每個都寫過設計文件，寫法也換過好幾種：純手寫、OpenSpec、大文件瀑布加審批、Matt Pocock 的 skills。每次開新專案都卡在同一個地方： 
▎ 模組怎麼拆、接口怎麼定、上下游怎麼接？ 
後來我想清楚了：拆成什麼樣是表，按什麼拆才是裡。 文件寫在哪、用什麼格式，換個工具就變。真正讓我每次都沒把握的，是「這裡為什麼該切一刀」「這兩塊為什麼該合併」的判斷依據。沒有這個依據，拆出來的結構只能靠感覺，換個需求就開始走樣。 
我查了三個熱門工具，結論是：它們給的都是表 
這三個工具我都直接讀了 10 月中旬最新版的原始碼： 

OpenSpec：技術棧寫在設定檔的一段自由文字裡。設計文件可寫可不寫，格式自由，跟著單次變更一起歸檔。至於按什麼標準拆模組，一句都沒有。
spec-kit：技術方案裡有 9 行固定的技術棧欄位、一份目錄樹、一份...