Guides

📌 【Simon Willison 實務指南】Coding Agent（Claude Code / Codex）最佳實踐全攻略

你以為只要讓 AI 寫程式，代碼品質就會自動升級？其實，掌握正確的「工程」方式，才能把 Claude Code、OpenAI Codex 變成真正的程式同事，而不是只會產出一堆「看起來對」的程式碼。

🤔 AI 讓寫程式變 cheap，但不代表品質會自動好

Simon Willison 最近在個人網站上發佈了一套 16 章節的實務指南，針對「agentic engineering」提供了從「如何避免常見反模式」到「用 Git、TDD、子代理」的全流程範例。對於想快速上手 Claude Code、OpenAI Codex，甚至想把 AI 融入每日開發流程的工程師，這份指南是最直接、可立即套用的手冊。

🧪 16 章節一次看懂 Coding Agent 的全貌

• What is agentic engineering?：定義「代理式工程」概念，說明 AI 不是替代開發者，而是協同工具。
• Writing code is cheap now：探討成本下降背後的風險與機會。
• Hoard things you know how to do：如何把熟悉的模式封裝成 Prompt，讓 AI 重複使用。
• AI should help us produce better code：把 AI 當作「品質保證」的助理，而非僅是「產出」機器。
• Anti‑patterns: things to avoid：列出 7 大常見坑（例如過度依賴單一步驟、忽略測試）。
• How coding agents work：簡要說明 Claude Code、Codex 的底層提示機制。
• Using Git with coding agents：示範在 Git workflow 中安全地接受 AI 產生的變更。
• Subagents：利用子代理分工（例如自動產生測試、文件、Dockerfile）。
• Red/green TDD：結合測試驅動開發，讓 AI 先寫失敗測試再產生通過程式。
• First run the tests：在執行 AI 產出前先跑測試，避免「程式碼已壞」的回饋循環。
• Agentic manual testing：手動測試的最佳提示，確保 AI 沒有隱藏錯誤。
• Linear walkthroughs：一步步帶領 AI 完成複雜任務的線性指令設計。
• Interactive explanations：讓 AI 解釋產生的程式碼，提升可讀性與可維護性。
• GIF optimization tool using WebAssembly and Gifsicle：實作範例，展示 AI 如何協助建立高效工具。
• Adding a new content type to my blog‑to‑newsletter tool：實際案例說明如何用 AI 擴充功能。
• Prompts I use：Simon 直接公開的 Prompt 集合，立即可貼上使用。

💡 核心發現：AI 產出要配合測試與迭代，才能真正提升品質

Simon 強調：「先跑測試 → 再讓 AI 修正」的迴路，讓開發者在每一次提示後都得到可驗證的回饋。這不僅防止「黑盒」程式碼流入主分支，也讓 AI 逐步學習開發者的風格與偏好。

⚠️ 研究限制：指南基於作者個人實務經驗，未經大規模實驗驗證

• 範例多以 Simon 自己的專案（部落格‑newsletter 系統）為基礎。
• 仍缺少跨團隊、跨語言的廣泛測試。
• 部分提示在特定模型（Claude Code、Codex）上表現最佳，其他模型可能需要微調。

🎯 實務建議：立刻把這 3 個步驟加入你的開發流程

1. Prompt Library：將常用 Prompt（如「產生單元測試」）保存於檔案，並在 CI 中自動呼叫。
2. Git‑AI Hook：在 pre‑commit 加入腳本，讓 AI 產生的變更先經過 git diff 與自動測試。
3. Iterative TDD：使用「Red/Green」流程，先讓 AI 產生失敗測試，再讓它修正程式碼，最後人工審核。

🔗 原文連結
📝 Guides – Simon Willison
🔗 https://simonwillison.net/guides/

如果你已在使用 Claude Code、Codex，或想把 AI 正式納入日常開發，快把 Simon 的 Prompt 直接貼上試試看，看看「AI 輔助」能為你的程式碼品質帶來多少提升！👇

#AI #CodingAgent #ClaudeCode #OpenAI #Codex #AgenticEngineering #DevOps #Git #TDD #PromptEngineering #SimonWillison