系統整頓4 min
手繪風格的巨大舊系統機械與電腦裝置,工程師離開後團隊站在旁邊,右側木橋延伸出文件與脈絡的光線

工程師離職那天,我們才發現:那座系統,原來沒有人真的「懂」它

工程師離開時,真正帶走的往往不是程式碼,而是那些沒被記錄下來的決策脈絡。文件不只是交接清單,也是讓下一個人和 AI 接得住系統的關鍵。

系統維護技術交接文件化AI 維運知識管理

那天的訊息很短,只有兩句:「想跟你聊一下,下個月我可能要離開了。」

接著就是長長的,很客氣的,補滿一段文字的「最近想要轉換跑道」。

我們收到那則訊息的當下,第一反應其實不是難過,是一陣輕微的暈眩。腦袋裡瞬間跳出來的不是「他要去哪」,而是——

「那台系統,誰來顧?」

一個人的腦袋,撐起整個營運

每一家走到第三年的小公司,幾乎都會有一個這樣的角色。

可能是當初幫忙寫網站的工程師朋友,可能是後來進來的第一個技術夥伴,也可能是創辦人自己。他們不一定是最厲害的那個,但他們是唯一一個「知道為什麼那一段會這樣寫」的人。

某段判斷邏輯為什麼長這樣?因為三年前有一個老客戶下單卡住,臨時加上去的。為什麼後台的會員等級欄位有兩個?因為當時跟舊資料合併時對不齊,留了一份備份。為什麼結帳頁某個按鈕會在週二自動隱藏?因為那是某個促銷沒下檔,後來懶得改。

這些事,都不在文件裡。它們在那個人的腦袋裡。

我們以為自己擁有的是一台系統,其實我們擁有的是一段「靠記憶在跑」的營運經驗。

兩週的交接,補不上三年的記憶

收到離職訊息的那兩週,是最焦慮的兩週。

我們開始一邊請對方錄影、一邊寫文件、一邊排會議。每天看著一份份新生出來的 Markdown 檔,標題寫著「金流邏輯說明」「會員資料結構」「上下架流程」。

那一刻會以為一切都來得及。

但等到他真的離開、新的人接手、第一個月遇到突發狀況時,才發現:

那些文件講的是「現在系統是怎麼運作的」,沒有講「為什麼當初要這樣設計」。

而真正卡住我們的,從來都不是前者,是後者。

文件不是寫給工程師看的,是寫給未來的我們

很多人會以為「寫文件」是工程師的事,是技術人的潔癖。

但真正會讓我們在三年後感謝過去自己的,是那一份份沒有人看的「決策紀錄」——當初為什麼選這個金流?為什麼決定不接 LINE Pay?為什麼會員等級從三層改成兩層?

這些東西,看起來瑣碎。可是它們才是讓系統「能被別人接手」的關鍵。

也是讓我們在某個工程師離開的下午,不至於得從頭打掉重練的,最後一道防線。

(會走到這一步很正常——大部分小公司都是先活下來,才有餘力顧到這件事。沒寫過文件不代表做錯什麼,只是還沒被生活逼到那一刻而已。)

AI 時代,文件變得更重要,而不是更不重要

最近大家很常聊 AI 工具能幫工程師寫多少程式、能幫忙除多少錯。

但我們慢慢發現一件事:AI 真正能幫我們做事,前提是它「看得懂我們的系統」。

當文件夠完整,AI 可以快速讀懂程式碼、提出修改建議、甚至協助日常維運。當文件一片空白,AI 也只能跟我們一樣茫然——對著一段沒有註解的程式碼,皺眉。

換句話說,過去文件是寫給下一個工程師看的,現在文件是寫給「下一個工程師 + 一個能 24 小時待命的 AI 助手」看的。

我們不是要把每一行程式都寫成論文。只要每一個重要決策,留下一兩段「為什麼」,未來的人(或未來的 AI)就有機會接得住這個系統。

真正會留下來的,不是程式碼,是脈絡

工程師會離開,這件事沒有什麼好怪的。

人都會走,公司都會換階段,這是健康的。

不健康的,是當他離開的那天,整個團隊發現自己對著螢幕眨眼,連從哪裡開始看都不知道。

所以與其問「下一個工程師什麼時候才找得到」,更值得問的,可能是:

「如果今天他走了,我們留得住多少?」

留得住的,從來不是程式碼,是脈絡。

(順帶一提,這篇文章本身也是一種文件——寫給三年後可能會忘掉今天為什麼要焦慮的我們自己看的。)

作者

營運前哨站

聚焦商家官網、內部系統整頓與 MVP 開發,整理真實專案裡常見的取捨、風險與落地做法。

發布:2026-04-25更新:2026-04-25字數:約 54