AI 編碼代理的正確打開方式：2026 年實戰工作流程

去年這個時候，讓 AI 寫程式碼還像在變魔術。現在，AI 編碼代理已經內建在幾乎所有主流 IDE 裡，討論的重點也從「它們能寫程式嗎」變成了「怎麼讓它們穩定產出好程式碼」。

關鍵差異不在你選了哪個工具。在於你的工作流程。

把 AI 當成你的實習生，不是你的替代品

別期待一行提示詞就得到完美的生產級程式碼。AI 編碼代理最適合被當作一個極度快速、極度博學的 junior 工程師：它讀過 Stack Overflow 上每一篇文章，但對你的專案一無所知。

給它上下文。一段好的 prompt 應該包含四件事：

• 你要做什麼 — 功能、檔案、函式
• 已經有什麼 — 它該參考的現有程式碼
• 限制條件 — 語言版本、框架、程式碼風格、該用或不該用的套件
• 預期行為 — 邊界條件、錯誤處理

在 src/middleware/ratelimit.ts 加入速率限制中介層。
參考 src/middleware/auth.ts 的實作模式。
使用 bottleneck 套件（已在 package.json 中）。
限制：每個 IP 每分鐘 100 次請求。超限時回傳 429 與 JSON 錯誤訊息。

比起只寫「加上 rate limiting」，這多花 30 秒，但可以省下 15 分鐘來回修正的時間。

先給規格，再給願望

模糊的提示詞產出模糊的程式碼；具體的提示詞產出第一次就跑得通的程式碼。最高效的 AI 編碼工作流程，始於一份像迷你設計文件的規格。

Andrej Karpathy 推廣的 CLAUDE.md 模式正在成為業界標準：為你的專案建立一份規則檔案，在每次請求 AI 之前，先告訴它你的技術棧、慣例、偏好模式和基本規則。

你的 CLAUDE.md（或 COPILOT.md、CURSOR_RULES.md）應該包含：

# 專案規則
- 使用 TypeScript strict 模式
- 優先使用函數元件而非類別元件
- 一律使用 async/await，禁止裸 promise
- 所有 API 路由必須用 zod 驗證輸入
- 測試檔放在原始檔旁邊：foo.ts → foo.test.ts
- 檔名用 kebab-case、變數用 camelCase
- 禁止 any 型別，用 unknown 並窄化

這個檔案會成為每次請求的前綴。時間一長，你就不需要一再重複「請用 zod 驗證」或「不要用 any」這類基本要求。

小批量、高頻率地交付

AI 產出 bug 的最大單一原因：一次要求太多。AI 代理可以在 10 秒內寫出 500 行程式碼，也可以在 10 秒內寫出 500 行 bug。如果你一次審查 500 行，根本抓不到那些 bug。

最佳批次大小：一個函式、一個元件、或一個聚焦的小修改。做完一段就審查、跑測試、確認沒問題再繼續。

好的節奏：

1. 為一個函式寫一份詳細的 prompt
2. 審查 AI 的輸出（30 秒）
3. 跑測試（5 秒）
4. 通過就 commit，不通過就修正或重新下 prompt
5. 重複

讓 AI 先寫測試

這是資深 AI 使用者最推薦的工作流程技巧。不要直接叫 AI 實作功能，先叫它寫測試。然後再叫它寫能讓測試通過的程式碼。

為 parseUserInput(input: string): ParsedUser 函式寫測試。
它要從逗號分隔字串中提取姓名、email 和年齡。
處理：空輸入、缺少欄位、無效 email、負數年齡。

審查完測試之後，再下第二道 prompt：

現在實作 parseUserInput，讓這些測試全部通過。

這個做法的好處是：AI 不是在猜你要什麼，而是在解決一組你已經看過並同意的斷言。你的審查重點從「實作的每一行對不對」變成「測試的邏輯對不對」——後者快得多。

知道什麼時候該收手

AI 編碼代理最擅長：樣板程式碼、重複性模式、設定檔、測試生成、文件、標準演算法。它們最不擅長：新穎的架構決策、難以重現的競爭條件、以及需要深思熟慮取捨的 API 設計。

一個好用的判斷標準：如果你能在 30 秒內對另一位工程師講清楚解決方案，AI 大概能實作出來。如果這個解決方案需要深厚的領域知識、取捨分析或創意思考，自己寫核心邏輯，讓 AI 處理周圍的樣板程式碼。

總結：2026 年的 AI 編碼工作流程

1. 設定（一次性）：建立專案規則檔案，一次性教會 AI 你的慣例
2. 規格：為每個功能寫一份包含上下文、限制條件和預期行為的 prompt
3. 測試先行：讓 AI 先寫測試，審查，核准
4. 實作：讓 AI 寫能通過測試的程式碼，一次一個函式
5. 審查：每一行都要讀，跑測試，只 commit 能動的程式碼
6. 迭代：出錯時把錯誤訊息丟給 AI，叫它修正特定問題

這不是最快使用 AI 編碼代理的方式。這是使用它們而不累積技術債的最快方式。在 2026 年，這個區別就是一切。