開發日誌 做了什麼 · 試過什麼 · 否決了什麼 · 留下了什麼
已否決 dev-blog 2026-W34 裁決 · 退場

「一個 repo 一篇」這個切法不成立

一個 repo 寫一篇總結,聽起來很乾淨,實際上會變成一篇沒人讀得完、也沒人寫得出來的東西。

AbstractThe "one post per repo" idea sounded clean but collapses under real history — replaced by calendar-based slicing.

那時候在想什麼

最初的想法很單純:每個 repo 寫一篇,講這個專案是什麼、做了哪些實驗、哪些留下來了,一頁講完。

寫起來也快。十幾個 repo 就十幾篇,一個週末可以清完。

實際做了什麼

拿 super-reversi 試算。九十二個 commit、十二天、三萬多行變動,涵蓋的東西包括整套響應式 CSS 重寫(vw 改 rem)、完整的 i18n、連擊系統從三連擊擴到七連擊、九級 AI、粒子特效系統。

要用一篇講完這些,那篇會變成流水帳。

更麻煩的是另一件事。寫成一篇總結,等於逼我把「當時的想法」壓縮成「後來的結論」。九月十三號那天我在改 CSS 單位,九月十四號在做 i18n,這兩件事之間發生了什麼、為什麼從版面跳到多語系,那個轉折才是有意思的地方。壓縮成總結之後,轉折就沒了,剩下的只有「這個專案做了 A、B、C」。

試過但沒留下

退一步想過折衷的做法:一個 repo 一篇,但用小標題分段,每段講一個主題。

還是不行。主題分段是事後的整理,我得先知道整件事的全貌才切得出主題,可是這個站的重點就是「當時不知道全貌」。用事後的架構去寫當時的過程,寫出來的東西會太聰明,不像那個當下。

結論

改成按曆格切。活躍期一週一篇,平淡期一個月一篇。切片的邊界由日曆決定,不是我事後決定的,這樣才逼得出「那一週我在想什麼」,而不是「這個專案的架構是什麼」。

super-reversi 用週切是三片,尾巴兩個 commit 的那片併進前一格,剩下兩篇,每篇二三十個 commit。那個量級講得完。

一個 repo 一篇這件事沒有留下來,可是它逼出了一個更重要的問題:切片的邊界該由誰決定。答案是日曆,不是我。