用 AI 寫程式不翻車:Vibe Coding 品質管控完全指南(非工程師也適用)
不會寫程式也能用 Claude Code 做出好產品。Plan-Do-Verify-Close 四步驟流程,讓你的 AI 專案不再越做越亂。
為什麼你的 AI 專案會越做越亂?
你有沒有遇過這些情況:
- 改了 A 功能,B 功能就壞了
- 程式碼越來越多,Claude 越來越搞不清楚
- Debug 一個問題,冒出三個新問題
- 每次開新 Session 都像從頭開始
根本原因:缺乏系統性的開發流程。
這不是你的問題,是因為沒有人教過你開發流程。好消息是,Claude 可以幫你執行這些流程,你只需要知道要請他做什麼。
核心概念:Plan → Do → Verify → Close
每一個功能都要走這四步,沒有例外:
Plan(規劃)→ 確認方向正確才開始
Do(執行)→ 按計畫寫程式
Verify(驗證)→ 檢查有沒有問題
Close(收尾)→ 整理文件,準備交接
接下來一步一步教你怎麼做。
Step 1:Plan(規劃)— 先想清楚再動手
在寫任何程式之前,先跟 Claude 說:
請先不要寫程式。
請幫我:
1. 分析這個功能的需求
2. 列出需要做的步驟
3. 評估每步的難度
4. 預估可能遇到的問題
5. 產出一份 plan.md
為什麼這步最重要?
- 避免做到一半發現方向錯了
- 減少來回修改浪費的 Token
- 讓你和 Claude 都清楚目標在哪
Plan 裡面一定要有「驗收標準」— 也就是「怎樣才算做完」。例如:
- ✅ 可以用正確的帳密登入
- ✅ 錯誤帳密會顯示錯誤訊息
- ✅ 手機版面正常顯示
Step 2:Do(執行)— 一次只做一件事
確認 Plan 沒問題後,告訴 Claude:
一次只做一個步驟。
每完成一個步驟告訴我結果。
三個關鍵原則:
1. 一次只做一件事
不要說「幫我把整個系統做好」,要說「先做第一步:建立登入頁面 UI」。
2. 用 Sonnet 執行
按 Plan 施工不需要 Opus,用 Sonnet 就夠了,省 Token。
3. 不要讓 Claude 自作主張
如果他說「我順便也幫你加了 XX 功能」→ 請他撤回。每次只做 Plan 裡有的步驟。
Step 3:Verify(驗證)— 做完一定要檢查
每個步驟完成後,跟 Claude 說:
檢查你剛才做的是否正確。
列出每個標準的通過/未通過狀態。
驗證清單:
- 功能是否正常運作?
- 有沒有引入新的 Bug?
- 是否符合 Plan 中的需求?
- 介面是否正常顯示?
- 手機版是否正常?
如果驗證不通過?跟 Claude 說:
請分析原因,提出修復方案,
但不要直接修改,先讓我確認。
重點是:不要讓 Claude 自己改,先看原因再決定怎麼修。
Step 4:Close(收尾)— 別忘了整理
功能完成且驗證通過後:
1. 更新 CLAUDE.md 的「目前進度」
2. 如果有重要決策,寫到 Memory
3. 產出交接文件(如果要開新 Session)
4. 列出下一步建議
為什麼收尾這麼重要?因為你的 Session 會結束、Context 會滿。如果沒有整理,下次開新 Session 就像失憶一樣從頭來過。
進階:用敏捷開發管理大型專案
如果你的專案不是做一兩天就完的,建議用敏捷開發的精簡版來管理。
簡單說:不要一次做完,分批做、分批驗收。
把大目標拆成「Sprint(衝刺週期)」,每個 Sprint 1-2 週,做 3-5 個小功能:
Sprint 1(第 1-2 週):基礎建設
建立專案架構 → 客戶清單頁面 → 新增客戶功能
✅ 驗收:可以新增和查看客戶
Sprint 2(第 3-4 週):核心功能
客戶編輯和刪除 → 搜尋和篩選 → 客戶詳細頁面
✅ 驗收:完整的 CRUD 功能
Sprint 3(第 5-6 週):進階功能
聯繫紀錄 → 報表 → 匯出 Excel
✅ 驗收:可以日常使用的版本
每個 Sprint 結束後,問自己三個問題:
- 做得好的:什麼地方順利?繼續保持
- 做得不好的:什麼地方卡住?怎麼改善
- 學到的:有什麼新發現?記到 Memory
DoD(完成定義):寫進 CLAUDE.md 的品質標準
「怎樣才算做完?」把這份清單寫在 CLAUDE.md 裡,Claude 每次做完都會自動對照:
功能面
- 功能正常運作
- 沒有明顯 Bug
- 邊界情況已處理(空值、極端值)
介面面
- 桌面版正常顯示
- 手機版正常顯示
- 有 Loading 狀態、錯誤提示、空狀態
品質面
- 程式碼整潔可讀
- 沒有安全漏洞
- 沒有硬編碼的敏感資訊
文件面
- CLAUDE.md 已更新
- 重要決策已記錄
常見問題
Q:我不是工程師,需要學這些嗎?
A:你不需要理解每個技術細節,但需要知道「什麼時候該做什麼」。就像你不需要會蓋房子,但需要知道先打地基再蓋牆。
Q:每個功能都要走四步嗎?
A:是的。小功能可以簡化(Plan 用口頭、Verify 快速看一下),但步驟不能省。
Q:Claude 一直修復同一個問題怎麼辦?
A:1. 開新 Session(可能是上下文污染)2. 用 Opus Review 問題的根本原因 3. 用更具體的驗收標準限制 Claude 的修改範圍。
Q:專案做到一半發現架構有問題?
A:正常!這時候用 Opus 做架構 Review,決定要不要重構。小問題修修補補,大問題值得打掉重來(用之前的 Plan 和學到的教訓)。
記住:Plan → Do → Verify → Close。每個功能都走一遍,你的專案就不會亂。
延伸閱讀 → Claude Code 非工程師完全指南 · 更多教學 → easyknowai.com
📦 懶人包:一鍵帶走
把所有 Prompt 複製到你的筆記,隨時可以用
📋 Vibe Coding 品質管控速查表(馬上懂AI) 【四步驟流程:Plan → Do → Verify → Close】 ━━ Step 1:Plan(規劃)━━ □ 跟 Claude 說「先不要寫程式」 □ 請 Claude 分析需求、列步驟、評估難度 □ 產出 plan.md,含驗收標準 □ 確認計畫沒問題才開始 ━━ Step 2:Do(執行)━━ □ 一次只做一個步驟 □ 用 Sonnet 執行(省 Token) □ Claude 自作主張加功能?請他撤回 □ 只做 Plan 裡有的步驟 ━━ Step 3:Verify(驗證)━━ □ 對照 plan.md 的驗收標準逐項檢查 □ 功能正常?沒有新 Bug?手機版正常? □ 未通過?分析原因,先確認再修 ━━ Step 4:Close(收尾)━━ □ 更新 CLAUDE.md 進度 □ 重要決策寫進 Memory □ 產出交接文件(給下次 Session) ━━ 完成定義(DoD)清單 ━━ □ 功能正常運作 □ 桌面版 + 手機版正常顯示 □ 有 Loading 狀態、錯誤提示、空狀態 □ 沒有安全漏洞或硬編碼敏感資訊 □ CLAUDE.md 已更新 💡 記住:每個功能都走四步,小功能可以簡化,但步驟不能省!