CLI Vibe Coding 快速技巧與心得
主要整理我這近期個人使用 Codex CLI 的心得與習慣,分享一些能在 vibe coding 時快速進入狀況的技巧。雖然我目前已經一段時間沒用 Claude code 了,但以下這些我自己的開發習慣與方法,在 Claude code 上應該也同樣適用。
1. 用文件定義你的 Coding Style 與 Design Pattern
在專案開始前準備一份簡單的文件,說明希望的:
命名規則(例如
camelCase、PascalCase)架構模式(例如 MVC、Repository Pattern)
檔案組織方式與命名慣例
讓 AI 在開發時能遵守你或團隊的風格,後續生成的程式碼會更一致更符合大家的閱讀習慣。
2. 善用 TODO 註解,進行部分的改動
AI生成程式時,很常會一次性大改動破壞整體邏輯,此時建議可以在程式中插入簡潔的 TODO 註解,例如:
# TODO: refactor this into a helper function
# TODO: add logging for user actions接著再讓 AI 根據這些 TODO 進行局部修改,避免過度生成或覆蓋既有程式。
3. 複雜任務先生成 TODO List 文件
現在的 AI 通常會先做「planning」──列出任務清單再開始生成程式碼。
但這個過程是自動化的,無法人工介入。
因此當任務較複雜時,建議先請 AI 幫你生成一份 todo_list.md 文件,
列出拆解步驟與預期動作。
這樣可以:
讓你有機會在實作前介入規劃階段
編輯、補充清單內容
確保後續的執行方向正確
4. 用 Mermaid UML 進行設計與討論
當程式結構或資料流過於複雜時,可以先請 AI 生成 Mermaid UML 文件,用視覺化方式檢視整體邏輯與架構。
這麼做有幾個好處:
提早發現架構錯誤或模組依賴問題
讓 AI 在後續開發時有更清晰的結構基準
可與 TODO list 搭配,在每項任務中附上 UML 說明,
讓整體架構更穩定、不容易走歪。
5. 使用函式庫或工具前,先搜尋開發文件
雖然目前的 AI 對主流框架支援很好,但版本落差仍是常見問題,而且有時生成的程式不會依照官方範本或 Best Practice。因此我會在 TODO list 的開頭就加上一項:
先搜尋相關的開發文件(官方連結)
這樣能確保 AI 生成的程式碼遵循最新文件與 Best Practice,減少後續除錯時間。
以上算是我自己個人在每次進行功能開發時,一定會用到的技巧,也歡迎大家分享自己的一些做法!
作者:Jason Liu