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

更新 發佈閱讀 4 分鐘
vocus|新世代的創作平台

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

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

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

「那台系統,誰來顧?」


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

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

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

某段判斷邏輯為什麼長這樣?因為三年前有一個老客戶下單卡住,臨時加上去的。

為什麼後台的會員等級欄位有兩個?因為當時跟舊資料合併時對不齊,留了一份備份。

為什麼結帳頁某個按鈕會在週二自動隱藏?因為那是某個促銷沒下檔,後來懶得改。

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

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


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

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

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

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

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

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

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


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

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

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

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

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

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


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

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

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

當文件夠完整,AI 可以快速讀懂程式碼、提出修改建議、甚至協助日常維運。

當文件一片空白,AI 也只能跟我們一樣茫然,對著一段沒有註解的程式碼,皺眉。

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

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


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

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

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

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

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

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

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

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

留言
avatar-img
給老闆看的工程師手記
210會員
22內容數
我是一位擅長將需求轉成程式碼的全端工程師,做過 300K 用戶平台、電商金流、企業內部系統。這裡寫給老闆和創業者看——不談語法,只談系統怎麼幫你跑生意。
2026/04/24
三年前,那套系統上線的時候,我們都鬆了一口氣。 訂單可以收了,金流可以跑了,後台可以看報表了。那個時候覺得,這就是我們要的,這就夠了。 然後就這樣過了三年。 「好像有點奇怪,但說不出哪裡怪」 很多時候,系統變慢不是某一天突然發生的。它是一點一點地積累~ 一開始是反應比以前慢一點,但還能用
Thumbnail
2026/04/24
三年前,那套系統上線的時候,我們都鬆了一口氣。 訂單可以收了,金流可以跑了,後台可以看報表了。那個時候覺得,這就是我們要的,這就夠了。 然後就這樣過了三年。 「好像有點奇怪,但說不出哪裡怪」 很多時候,系統變慢不是某一天突然發生的。它是一點一點地積累~ 一開始是反應比以前慢一點,但還能用
Thumbnail
2026/04/21
有一種混亂,不是因為生意不好,而是因為生意越來越好。 一開始只有 LINE,客人傳訊息過來,我們手動記、手動備貨、手動回覆出貨時間。那時候還好,單量少,每一筆都記得住。 後來有人說「應該開蝦皮,曝光比較廣」,就開了。蝦皮的訂單從後台跑進來,跟 LINE 是兩個完全不同的地方。 再後來,自己又做
Thumbnail
2026/04/21
有一種混亂,不是因為生意不好,而是因為生意越來越好。 一開始只有 LINE,客人傳訊息過來,我們手動記、手動備貨、手動回覆出貨時間。那時候還好,單量少,每一筆都記得住。 後來有人說「應該開蝦皮,曝光比較廣」,就開了。蝦皮的訂單從後台跑進來,跟 LINE 是兩個完全不同的地方。 再後來,自己又做
Thumbnail
2026/04/11
很多老闆、新創團隊,或是想翻修舊系統的人,第一句話通常是:「我想做一套新的。」 有些人想重做官網,有些人想重整後台,也有人開口就是想導入 AI。表面上看起來,大家要的東西不一樣,但我們實際聊下去後,常常會發現他們卡住的地方其實很像。 真正讓專案停住的,往往不是技術做不做得到,而是他們還沒把問題定
Thumbnail
2026/04/11
很多老闆、新創團隊,或是想翻修舊系統的人,第一句話通常是:「我想做一套新的。」 有些人想重做官網,有些人想重整後台,也有人開口就是想導入 AI。表面上看起來,大家要的東西不一樣,但我們實際聊下去後,常常會發現他們卡住的地方其實很像。 真正讓專案停住的,往往不是技術做不做得到,而是他們還沒把問題定
Thumbnail
看更多
你可能也想看
Thumbnail
我在網頁領域打滾 5 年多,2017年擔任網頁設計師(ui/ux設計師)後來轉換跑道2018年成為網頁工程師(前端工程師),要從0開始自行架設網站絕對是具備能力,但創業到現在我仍然沒有選擇架設網站,想跟大家分享身為現役網頁工程師我會選擇不架設網站的理由。 擁有自己的品牌官網? 是想要還是必要?
Thumbnail
我在網頁領域打滾 5 年多,2017年擔任網頁設計師(ui/ux設計師)後來轉換跑道2018年成為網頁工程師(前端工程師),要從0開始自行架設網站絕對是具備能力,但創業到現在我仍然沒有選擇架設網站,想跟大家分享身為現役網頁工程師我會選擇不架設網站的理由。 擁有自己的品牌官網? 是想要還是必要?
Thumbnail
全新版本的《三便士歌劇》如何不落入「復刻經典」的巢臼,反而利用華麗的秀場視覺,引導觀眾在晚期資本主義的消費愉悅之中,而能驚覺「批判」本身亦可能被收編——而當絞繩升起,這場關於如何生存的黑色遊戲,又將帶領新時代的我們走向何種後現代的自我解構?
Thumbnail
全新版本的《三便士歌劇》如何不落入「復刻經典」的巢臼,反而利用華麗的秀場視覺,引導觀眾在晚期資本主義的消費愉悅之中,而能驚覺「批判」本身亦可能被收編——而當絞繩升起,這場關於如何生存的黑色遊戲,又將帶領新時代的我們走向何種後現代的自我解構?
Thumbnail
本文章提供前端開發的完整知識地圖,涵蓋 JavaScript 基礎概念、進階概念、前端開發基礎、前端框架與工具、系統設計與架構,以及開發工具與實作等面向,並以 SEO 友善的方式撰寫,適合想學習前端開發或準備面試的讀者。
Thumbnail
本文章提供前端開發的完整知識地圖,涵蓋 JavaScript 基礎概念、進階概念、前端開發基礎、前端框架與工具、系統設計與架構,以及開發工具與實作等面向,並以 SEO 友善的方式撰寫,適合想學習前端開發或準備面試的讀者。
Thumbnail
若說易卜生的《玩偶之家》為 19 世紀的女性,開啟了一扇離家的窄門,那麼《海妲.蓋柏樂》展現的便是門後的窒息世界。本篇文章由劇場演員 Amily 執筆,同為熟稔文本的演員,亦是深刻體察制度縫隙的當代女性,此文所看見的不僅僅是崩壞前夕的最後發聲,更是女人被迫置於冷酷的制度之下,步步陷入無以言說的困境。
Thumbnail
若說易卜生的《玩偶之家》為 19 世紀的女性,開啟了一扇離家的窄門,那麼《海妲.蓋柏樂》展現的便是門後的窒息世界。本篇文章由劇場演員 Amily 執筆,同為熟稔文本的演員,亦是深刻體察制度縫隙的當代女性,此文所看見的不僅僅是崩壞前夕的最後發聲,更是女人被迫置於冷酷的制度之下,步步陷入無以言說的困境。
Thumbnail
行銷人遇到 SEO 報表看不懂、網頁圖片抓不到、懷疑外包網站用盜版主題怎麼辦?本文提供 3 個 ChatGPT 實戰場景,讓你無需依賴工程師,也能用 AI 解決代碼與數據難題,建立高效工作流。
Thumbnail
行銷人遇到 SEO 報表看不懂、網頁圖片抓不到、懷疑外包網站用盜版主題怎麼辦?本文提供 3 個 ChatGPT 實戰場景,讓你無需依賴工程師,也能用 AI 解決代碼與數據難題,建立高效工作流。
Thumbnail
長期以來,西方美學以《維特魯威人》式的幾何比例定義「完美身體」,這種視覺標準無形中成為殖民擴張與種族分類的暴力工具。本文透過分析奈及利亞編舞家庫德斯.奧尼奎庫的舞作《轉轉生》,探討當代非洲舞蹈如何跳脫「標本式」的文化觀看。
Thumbnail
長期以來,西方美學以《維特魯威人》式的幾何比例定義「完美身體」,這種視覺標準無形中成為殖民擴張與種族分類的暴力工具。本文透過分析奈及利亞編舞家庫德斯.奧尼奎庫的舞作《轉轉生》,探討當代非洲舞蹈如何跳脫「標本式」的文化觀看。
Thumbnail
整個二月,又是一個變化很大的月。我幾乎把一整年的案子,都談好了。 接案量依舊很多,除了已經確定要寫的兩本書,還有持續詢問的網站案,加上我個人創業、合夥,今年工作已經很滿了。 其中有特別的,是新增一項合夥,會在基隆成立類似創業聚落的社群,和一位在地深耕創業領域許久的朋友合作。 開心的地方...
Thumbnail
整個二月,又是一個變化很大的月。我幾乎把一整年的案子,都談好了。 接案量依舊很多,除了已經確定要寫的兩本書,還有持續詢問的網站案,加上我個人創業、合夥,今年工作已經很滿了。 其中有特別的,是新增一項合夥,會在基隆成立類似創業聚落的社群,和一位在地深耕創業領域許久的朋友合作。 開心的地方...
Thumbnail
這個月,忽然達成 2 個里程碑。 第一個里程碑,是我在 2022 年底,有訂下 2023 年的創業月收入(不含合夥),想要盡可能達到 2 萬元生活費。 我並沒有全心投入創業行銷,而是被動行銷,想嘗試會如何。所以我 2023 年每月的創業大概是 1 萬元上下,而今這個月計算下來,忽然發現達到...
Thumbnail
這個月,忽然達成 2 個里程碑。 第一個里程碑,是我在 2022 年底,有訂下 2023 年的創業月收入(不含合夥),想要盡可能達到 2 萬元生活費。 我並沒有全心投入創業行銷,而是被動行銷,想嘗試會如何。所以我 2023 年每月的創業大概是 1 萬元上下,而今這個月計算下來,忽然發現達到...
Thumbnail
我們油菜一家透過『好聰敏3益生菌』改善了換季流鼻水、腸胃不適等問題。此產品採用冷凍配送及透明的產品資訊,讓油菜先生留下深刻印象。文章詳細介紹產品特色、食用方式及食用後的變化,並分享其值得推薦的原因。
Thumbnail
我們油菜一家透過『好聰敏3益生菌』改善了換季流鼻水、腸胃不適等問題。此產品採用冷凍配送及透明的產品資訊,讓油菜先生留下深刻印象。文章詳細介紹產品特色、食用方式及食用後的變化,並分享其值得推薦的原因。
Thumbnail
本文深度解析賽勒布倫尼科夫的舞臺作品《傳奇:帕拉贊諾夫的十段殘篇》,如何以十段殘篇,結合帕拉贊諾夫的電影美學、象徵意象與當代政治流亡抗爭,探討藝術在儀式消失的現代社會如何承接意義,並展現不羈的自由靈魂。
Thumbnail
本文深度解析賽勒布倫尼科夫的舞臺作品《傳奇:帕拉贊諾夫的十段殘篇》,如何以十段殘篇,結合帕拉贊諾夫的電影美學、象徵意象與當代政治流亡抗爭,探討藝術在儀式消失的現代社會如何承接意義,並展現不羈的自由靈魂。
Thumbnail
在這個數位時代,幾乎人人有手機有電腦,每天都會接觸網站或 APP。你打開手機滑臉書、用foodpanda 網路訂餐、上網查資料,甚至於近兩年快速登上科技時代的最佳主角:AI ,背後都是由一群默默耕耘的軟體工程師在支撐。 今天,就讓我們從基礎的網站架構談起,一步步認識工程師的世界。
Thumbnail
在這個數位時代,幾乎人人有手機有電腦,每天都會接觸網站或 APP。你打開手機滑臉書、用foodpanda 網路訂餐、上網查資料,甚至於近兩年快速登上科技時代的最佳主角:AI ,背後都是由一群默默耕耘的軟體工程師在支撐。 今天,就讓我們從基礎的網站架構談起,一步步認識工程師的世界。
Thumbnail
每到月底,都以為這個月沒做什麼事,結果回顧後,總是發現做了好多好多。 這個月最大的事件,是談成一件近百萬的大案子,此外我有增加一位固定付費的工程師,固定幫我維護官方網站,更新部落格文章。 我還開設新的電子報企劃,期待能產生新的迴響。而這個月的挑戰賽也開始,並超級順利的結束了。最後,我還帶著家人去
Thumbnail
每到月底,都以為這個月沒做什麼事,結果回顧後,總是發現做了好多好多。 這個月最大的事件,是談成一件近百萬的大案子,此外我有增加一位固定付費的工程師,固定幫我維護官方網站,更新部落格文章。 我還開設新的電子報企劃,期待能產生新的迴響。而這個月的挑戰賽也開始,並超級順利的結束了。最後,我還帶著家人去
追蹤感興趣的內容從 Google News 追蹤更多 vocus 的最新精選內容追蹤 Google News