工程 · 2 min read
文件怎麼過期的
每個 pull request 都讓 AI 寫一份審查紀錄，四個月後我們刪掉了 80 份。為什麼寫得輕鬆的文件照樣會過期，以及為什麼文件一定要設計成容易改。
我們團隊的一個服務，從 2026 年 6 月開始做一件事。每個 pull request，都讓 AI 寫一份審查紀錄，存進 repo。
四個月後，我們刪掉了 80 份。
為什麼刪
每一份紀錄，都是某一刻的純文字快照。合併之後，它就過期了。之後沒有人再讀它。它還多了一道要維護的關卡。
AI 讓寫文件變得很輕鬆。但寫得輕鬆的文件，不會自己活下來。
一份文件過期的循環
這個循環沒有一個壞人。每一步都很合理，結果卻是文件過期。
技術債能避免嗎
想像最好的情況。沒有 deadline，你今天的設計完美。明天，世界改變了，你也學到新的東西。
套用 DIKW（資料、資訊、知識、智慧）的分層，我們管理的是知識層。新的學習會一直改寫這一層。所以文件必須容易改。它永遠不會完成。
改變我們的期待
| 不要期待 | 要期待 |
|---|---|
| 一個永遠不用改的完美結構，不論來自 AI 還是流程 | 一個找到更好方法時，可以重構的結構 |
| 文件永遠正確 | 文件錯了，有辦法快速修好（補償機制） |
下一步是列出原因，再分類。哪些 AI 能解決，哪些不行，見先找痛點再選工具。
文件不會完成，只會過期。所以要設計成容易改。
參考來源
延伸閱讀： 看看哪些原因 AI 修得了，直接跳到讓文件一直活著的三個提醒。或回到系列總覽：AI 時代，文件怎麼活下來