接手一個「寫到一半的專案」通常是有點頭痛的情境，有時候需求、程式碼、版本、註解都不一定一致，甚至會出現「功能做到一半」、「流程寫錯方向」、「拿到舊版本」的情況。
於是整理了一套自己實際用、而且有用的框架。這篇文章就分享我的整理順序與思考方式。
Photo by Justin Morgan on Unsplash
1. 先釐清現況：把「現在做到哪裡」弄清楚
接手專案時，最容易犯的錯就是急著下去改程式。
我覺得比較好的第一步是，先盤點與釐清。
這個專案現在到底做到哪裡？跟需求差多遠？
- 對照需求規格書：把需求拆成模組與功能，並逐項比對。哪些完成、哪些沒做、哪些做錯方向，一目了然。
- 實際執行（能跑的部分先跑）：即使會噴錯也沒關係，只要能看到 log、畫面或流程。
- 整理初步完成度：我會做成一張 Excel，用最簡單的欄位：
做到這裡，會知道混亂其實不是不可控，是可以紀錄、可以被拆解的。
同時，心態上也會比較踏實，比較有個方向而不慌亂。
2. 建立差異清單：把「問題」變成可以追蹤的項目
目的就是把所有未完成或不一致的地方全部攤開。
這份表是接手專案最關鍵的文件，因為：
- 它可以讓你知道所有缺漏
- 它可以跟主管或需求端確認現階段 scope
- 它會變成後續開發計畫的基礎
- 它讓你不會忘記任何一件待修項目
差異清單不需要複雜，它的重點是能清楚描述每個問題的狀態與風險
3.建立修復與開發計畫：從「差異」到「可執行任務」
當你知道哪些東西未完成後，下一步就是：
把問題變成任務，把任務按順序執行
心態上就會更加穩固，我是在「按順序完成一個個的 tasks」。
4. 測試策略：跑通 → 驗證 → 測試
我對於接手的專案，不會在開發同時寫單元測試（unit test），通常這種專案時間會比較緊湊，而且在還沒跑通前，根本不知道真正的邏輯與資料流會變成什麼樣。
所以我的測試流程是：
- 先跑起來（Smoke Test） : Smoke Test 的目標只有一個：整條 pipeline 能跑到結尾，不噴錯即可。
只要確認：
- main.py 能啟動
- 模組間可以互相呼叫
- 不會在中間報 exception
- pipeline 能從頭跑到尾
這樣就算過。Smoke Test 的精神是「系統有沒有活著」
2. 再逐模組驗證（Component Test）
這階段才開始真正修功能。
- 修
initializer→ 用小筆假資料跑看看 - 修
preprocessor→ 看特徵工程有沒有正常產生 - 修
predictor→ 看模型能不能跑推論
每修一項，就測一次。
這樣可以確保你不會「修完一堆，結果壞掉更多」
3. 最後再補單元測試（Unit Test / Regression Test）
整個流程確定穩定可跑時，才是寫單元測試的時機。
這些測試主要是：
- 防止未來改壞
- 讓 pipeline 可以做 regression test
- 讓下一個接手的人能放心
讓專案變成可維護
小結
接手做到一半的專案按照這樣的流程與框架去作業，就不會覺得非常混亂。慢慢地把一個一個變成可控，最後就能完成上線。
簡單的流程是：
先釐清 → 建差異 → 做計畫 → 按測試階層推進
如果你也正接手類似的專案，希望這篇分享也能幫助到你。
