Guides

📌 Simon Willison 的《Guides》： Coding Agents 實戰模式彙總

你有試過讓 Claude Code、OpenAI Codex 寫完程式，卻發現自己越來越不懂原理嗎？這份指南告訴你怎麼避免該陷阱，讓 AI 成為你的學習夥伴而非取代思考的工具。

🤔 AI 輔助編程工具普及，但卻可能讓開發者的理解力下降
隨著 Claude Code、OpenAI Codex 等 coding agents 成為日常，開發者面臨新的挑戰：如何在提升效率的同時，不喪失對程式碼的深度理解。

🧪 根據作者實務經驗整理的 16 個章節模式
這份指南由 Simon Willison 編撰，內容分為 16 個章節，涵蓋概念、工作流程與實務技巧，例如：

• What is agentic engineering?
• Writing code is cheap now
• Hoard things you know how to do
• AI should help us produce better code
• Anti‑patterns: things to avoid
• How coding agents work
• Using Git with coding agents
• Subagents
• Red/green TDD
• First run the tests
• Agentic manual testing
• Linear walkthroughs
• Interactive explanations
• GIF optimization tool using WebAssembly and Gifsicle
• Adding a new content type to my blog‑to‑newsletter tool
• Prompts I use

💡 提供可直接適用的模式與反模式，幫助開發者更好地與 coding agents 合作
指南強調「讓 AI 幫助我們產出更好程式碼」與「避免讓 AI 取代思考」的實務做法，並列出具體的反模式（Anti‑patterns）作為警示。透過章節中的範例與提示詞（Prompts I use），讀者可以立即將這些模式套用到自己的專案中。

🔍 區分『用 AI 建立理解』與『用 AI 取代思考』的關鍵行為
從章節標題可見，作者鼓勵先讓 AI 產出初稿，再透過追問、解釋、自行撰寫等步驟來鞏固理解；而完全依賴 AI 撰寫、除錯或直接接受輸出則屬於容易導致理解淺薄的行為。

⚠️ 屬於經驗總結而非實證研究，缺乏控組數據
此為作者根據個人實踐整理的最佳實踐指南，並未進行對照實驗或統計分析，因此結論屬於經驗建議而非經證據。

🎯 依照指南的模式，可即時改進你的 coding agent 工作流程

• 在撰寫程式前，先閱讀「Writing code is cheap now」與「Hoard things you know how to do」章節，建立可重用的知識庫。
• 使用「Red/green TDD」與「First run the tests」確保 AI 產出的程式碼能通過測試。
• 透過「Interactive explanations」與「Linear walkthroughs」讓 AI 說明每一步的目的，強化自身理解。
• 參考「Prompts I use」章節，調整你與 coding agents 的對話方式，避免落入 Anti‑patterns。

🔗 論文連結
📝 Guides
👤 Simon Willison
🔗 https://simonwillison.net/guides/

你目前與 coding agents 的互動方式是哪一種？歡迎在留言區分享你的經驗與技巧 👇

#AI #CodingAgents #ClaudeCode #OpenAICodex #SimonWillison #軟體工程 #開發實務