鐵人檔案
接手一套原生 PHP、無框架、運作多年的 legacy 系統，嘗試讓 AI coding agent 參與重構。這系列記錄的不是「叫 AI 生成程式碼」的表面示範，而是一整套讓 AI 安全動手的方法論：怎麼建立分支基準與覆蓋率門檻、怎麼設計驗證機制抓出 AI 引入的迴歸、怎麼把 AI 的長期記憶用在團隊協作上。內容基於真實重構經驗，但已去識別化。
前言：介面化一支函式很簡單，一整家廠商呢？ 「昨天講的 PSR-17/18 介面化，聽起來就是把一支函式包一包，套用到整套廠商接線應該也差不多吧？」 如果只有一...
前言：反正都在同一個 repo，共用套件不是很正常嗎？ 「廠商整合的 package 就放在專案裡面，外層專案已經裝了一堆套件，package 直接拿來用不是很...
前言：這段程式碼在正式環境跑了三年都沒事，怎麼會有 bug？ 「這個類別已經在正式環境穩定跑了三年，你確定它有問題？」 這是我請 AI 修一個 DI 容器單例的...
前言：物件建立成功，代表它是對的嗎？ 「這個物件都能正常 new 出來、程式也沒噴任何錯誤，代表這個依賴注入設定是對的吧？」 答案是：不一定。今天要講的這個陷阱...
前言：這條規則 AI 明明知道，為什麼還是會忘記套用 「金額運算要用 bcmath，不要用浮點數」——這條規則寫在專案規範裡，隨便問哪個 AI coding a...
前言：規則寫給 AI 看，但寫在哪裡才有用？ 「這條規則我明明寫在專案文件裡了，AI 怎麼還是沒套用？」 如果你也遇過這種情況，問題往往不在「有沒有寫」，而在「...
前言：規則講過一次，AI 下次還會忘記嗎？ 「昨天才糾正過 AI 一個錯誤判斷，今天換個任務，它是不是又會犯一樣的錯？」 會的——如果那個教訓只留在昨天那次對話...
前言：不是每件事都值得寫成 skill 「昨天講完怎麼把一次性踩坑經驗提煉成 skill，那是不是以後每件事都該往 skill 裡塞？」 不是。skill 是給...
前言：記住「使用者不喜歡什麼」，真的有用嗎？ 「AI 被糾正過的事情，記下來下次不要再犯不就好了嗎？」 聽起來理所當然，但真正動手設計這套記憶機制時,會發現「記...
前言：AI 說「我記得」，是好事還是壞事？ 「AI 有長期記憶,不用每次都重新解釋專案背景,這樣效率不是更高嗎？」 效率確實更高——直到那份記憶跟現實脫節的那一...
