接手 AI 與 Cursor 開發專案前的 7 大危險信號檢查清單

當代軟體開發中，越來越多專案完全依賴 AI 輔助工具（如 Cursor、Claude Code 等）生成，然而光鮮亮麗的功能背後往往隱藏著龐大的 技術債。為了幫助開發者在接手或重構 AI 產出的程式碼前進行評估，本文整理了一份 5分鐘預先驗收檢查清單。

• 硬編碼機密：API 金鑰、權杖或資料庫憑證直接寫在原始碼中，而非使用 .env 或密鑰管理器。 • 零測試覆蓋率：關鍵商業邏輯連基本的冒煙測試或單元測試都沒有。 • 巨型原始檔案：程式碼未經重構，單一檔案膨脹至 2000 行以上。 • 混亂的 Git 歷史：大量毫無意義的提交訊息，例如「fix」、「update」或「Cursor auto commit」。 • 未鎖定依賴版本：套件版本隨意浮動，幾乎保證下個月建置會失敗。 • 缺乏部署與安裝文件：沒有 README.md、沒有 Dockerfile，完全沒有本機執行說明。 • 依賴膨脹與衝突：多個重複或衝突的函式庫執行完全相同的功能。

「這些問題單獨來看或許不是絕對的交易破局點，但如果在快速掃描時發現 3 個以上，我會自動將工作時間估算加倍。」

這份清單能有效幫助技術主管在接手 vibe-coded 專案時，精準評估維護成本與潛在風險。