AI Coding 流程
從一個點子到持續營運，AI Coding 不是寫完就結束，而是橫跨 4 個時期、12 個階段的循環。每一階段都附上「為什麼重要、怎麼做、常見錯誤、你會得到什麼」。
延伸：怎麼跟 AI 合作（協作守則） →規劃
想清楚再動手：把模糊的點子變成 AI 能執行的計畫。
- 1
Idea 想法
先把「想解決什麼問題、給誰用」說清楚，一句話講得出來最好。
- 為什麼重要
- 方向錯，後面做再多都白費；先確定值得做，再開工。
- 怎麼做
- 用一句話寫下「為誰、解決什麼問題」，講給朋友聽他要能聽懂。
- 常見錯誤
- 一次想塞進十個功能，最後什麼都做不完。
- 你會得到
- 一句話就能說清楚的產品定位。
- 2
Spec 需求
把想法拆成具體功能與規則，讓 AI 知道「成功長什麼樣」。
- 為什麼重要
- AI 只會照你說的做；說不清楚，它就猜，猜錯往往最後才發現。
- 怎麼做
- 列出主要功能、使用流程，以及「不做什麼」，交給 AI 當任務說明。
- 常見錯誤
- 把「希望」當成「需求」，卻沒定義什麼叫做完成。
- 你會得到
- 一份功能清單與驗收標準。
- 3
Architecture 架構
決定前端、後端、資料庫怎麼擺，先畫圖再寫程式。
- 為什麼重要
- 先決定零件怎麼擺，日後要改才不會牽一髮而動全身。
- 怎麼做
- 請 AI 畫出前端、後端、資料庫的關係圖，看懂了再往下。
- 常見錯誤
- 還沒想清楚就開寫，中途才發現架構撐不住。
- 你會得到
- 一張架構圖與技術選型。
- 4
Planning 規劃
把工作切成一個個小步驟，讓 AI 一次只專心做一件事。
- 為什麼重要
- 大任務一次丟給 AI 容易失焦；切成小步它才做得準。
- 怎麼做
- 把功能拆成一條條能獨立完成、能各自驗證的小任務。
- 常見錯誤
- 步驟太大又彼此相依，一個卡住就全部停擺。
- 你會得到
- 一份有先後順序的任務清單。
建構
讓 AI 寫、你把關：產出能跑且讀得懂的程式碼。
- 5
Implementation 實作
AI 依計畫寫程式，你負責確認方向、補充情境。
- 為什麼重要
- 這是 AI 最強的一段，但方向對不對要你把關。
- 怎麼做
- 一次只給一個任務，看它寫、即時補情境，不滿意就重講。
- 常見錯誤
- 全盤接受 AI 的程式碼，沒讀懂就往下做。
- 你會得到
- 能實際跑起來的功能程式碼。
- 6
Code Review 程式審查
讓另一個 AI（或你）檢查邏輯對不對、好不好維護。
- 為什麼重要
- 能跑不等於寫得好；現在不檢查，債就留給未來的你。
- 怎麼做
- 換一個 AI（或你自己）逐段問「這樣對嗎、好維護嗎」。
- 常見錯誤
- 只看有沒有錯，不看好不好讀、好不好改。
- 你會得到
- 一份修正過、讀得懂的程式碼。
驗收
上線前的層層關卡：安全、契約、測試一一過關。
- 7
Security Review 安全審查
專門找漏洞：權限、輸入驗證、機密外洩，上線前必做。
- 為什麼重要
- 一個漏洞就可能外洩使用者資料，這是上線前的最後防線。
- 怎麼做
- 請 AI 專門檢查權限、輸入驗證，以及機密有沒有被寫死在程式裡。
- 常見錯誤
- 以為「沒人會攻擊我的小專案」就整段跳過。
- 你會得到
- 一份漏洞清單與對應的修補。
- 8
Contract Validation 契約驗證
確認前後端對「資料長什麼樣」的約定一致，避免接不上。
- 為什麼重要
- 前後端對資料格式認知不一致，畫面就會接不上、跳錯誤。
- 怎麼做
- 確認兩邊送出與接收的欄位一致，最好共用同一份格式定義。
- 常見錯誤
- 各寫各的，等串起來才發現欄位名稱、型別兜不攏。
- 你會得到
- 一份雙方都遵守的資料格式定義。
- 9
Integration Test 整合測試
把各部分串起來一起測，確認合作時不會出錯。
- 為什麼重要
- 每個零件單獨好，合起來不一定好；串起來跑才知道。
- 怎麼做
- 請 AI 寫測試把幾個功能串在一起跑，模擬真實流程。
- 常見錯誤
- 只測單一功能，從來不測「彼此合作」的情境。
- 你會得到
- 一組會自動執行的整合測試。
- 10
Runtime Test 實機測試
在接近真實的環境跑起來，像真用戶一樣操作看看。
- 為什麼重要
- 自動測試測不到的「手感」與真實環境問題，得親手點過才知道。
- 怎麼做
- 在接近正式的環境，像真實使用者那樣從頭操作一遍。
- 常見錯誤
- 只在自己電腦上跑過，就覺得一定沒問題。
- 你會得到
- 一份真實操作下發現的問題紀錄。
營運
送上線並持續守護：部署、觀測、迭代。
- 11
Deploy 部署
把產品推上線，讓全世界都能連到（本站用 Cloudflare Pages）。
- 為什麼重要
- 沒上線就沒有人用得到；部署是把成果交到使用者手上。
- 怎麼做
- 選一個託管平台（本站用 Cloudflare Pages），設好網域與環境變數再推上去。
- 常見錯誤
- 把密碼、金鑰直接寫死在程式裡，一起送上線。
- 你會得到
- 一個外部使用者連得到的正式網址。
- 12
Monitoring 監控
上線後持續觀察：有沒有壞掉、快不快、有沒有異常。
- 為什麼重要
- 上線不是終點；壞掉、變慢、被攻擊，你都該比使用者先知道。
- 怎麼做
- 設好錯誤告警與基本數據，定期查看，並把學到的帶回下一輪。
- 常見錯誤
- 上線後就不再看了，使用者比你更早發現出事。
- 你會得到
- 一套會主動通知你的觀測機制。