[Open Source] **AI程式碼大師指南，上手只需現在，別錯過！**

讓你的AI程式碼更聰明：Karpathy風格的Claude程式碼撰寫指南 (給台灣開發者的實用攻略)

哈囉，各位熱愛程式碼的台灣朋友們！👋 今天我們要聊聊一個能讓你用AI寫程式碼更上一層樓的秘密武器：Karpathy風格的Claude程式碼撰寫指南。如果你是程式新手，或是想提升使用AI輔助程式碼的效率，這篇文章絕對能幫到你！

為什麼需要這個指南？ 🤔

你可能已經開始使用像Claude這樣的AI程式碼助手，但你有沒有遇到過以下情況：

• AI程式碼助手好像「過度思考」，寫出來的程式碼又臭又長，難以維護？
• AI助手自作主張，修改了你不希望它碰的地方，甚至把你的程式碼搞壞了？
• AI助手沒有搞清楚你的需求，寫出的程式碼跟你要的功能南轅北轍？

這些都是使用AI程式碼助手時常見的問題。而Karpathy風格的Claude程式碼撰寫指南，正是為了解決這些問題而生的！ 💡

什麼是Karpathy風格？ 🧐

這個指南的靈感來自於Andrej Karpathy（特斯拉AI總監，同時也是一位備受尊敬的AI科學家）對大型語言模型（LLM）寫程式碼的觀察。他發現，LLM在寫程式碼時，常常會犯一些錯誤，例如：

• 錯誤的假設：AI助手會自己腦補，沒有確認就開始寫程式碼。
• 過度複雜化：程式碼寫得過於複雜，增加了維護的難度。
• 不必要的修改：修改了與任務無關的程式碼，或是沒有搞清楚就刪除程式碼。

Karpathy風格的指南，就是一套針對這些問題的解決方案。它讓你更好地引導AI助手，寫出更清晰、更簡潔、更可靠的程式碼。

四大原則，讓你成為AI程式碼大師！ 🏆

這個指南的核心，是四個簡單卻強大的原則，它們能幫助你改善使用AI寫程式碼的體驗：

1. 先思考，再動手 (Think Before Coding)
2. 簡潔至上 (Simplicity First)
3. 精準修改 (Surgical Changes)
4. 目標導向的執行 (Goal-Driven Execution)

讓我們來更深入地了解一下這四個原則：

1. 先思考，再動手 (Think Before Coding) 🧠

這個原則強調在寫程式碼之前，先釐清需求，並消除歧義。它能幫助AI助手避免做出錯誤的假設，並更準確地理解你的意圖。

具體做法：

• 明確地說明假設：如果對某些細節不確定，不要猜測，直接問！例如：「我假設使用者輸入的是有效的Email格式，請問這個假設是否正確？」
• 提出多種解釋：當有多種可能的解釋時，不要讓AI助手自行選擇，而是讓它列出所有可能性，讓你來決定。
• 提出質疑：如果AI助手提出的方案有問題，或是你有更好的想法，直接提出質疑！
• 遇到困惑就停下來：如果AI助手遇到困難，先弄清楚原因，並尋求你的協助。

舉例說明：

假設你要求AI助手寫一個驗證Email地址的函數。在沒有這個原則的情況下，AI助手可能會直接開始寫程式碼，但它可能沒有考慮到：

• Email格式的嚴格程度
• 是否需要檢查網域是否存在
• 需要支援哪些語言

遵循「先思考，再動手」的原則，你可以這樣引導AI助手：

我希望你寫一個函數來驗證Email地址的格式。在開始之前，請先回答以下問題：

1.  你認為Email格式驗證需要遵循哪些標準？（例如，是否要符合RFC標準？）
2.  你是否需要驗證網域是否存在？
3.  這個函數需要支援哪些程式語言？

通過這些問題，你能確保AI助手理解你的需求，並避免寫出不符合你預期的程式碼。

2. 簡潔至上 (Simplicity First) ✂️

這個原則的重點是保持程式碼的簡潔性，避免不必要的複雜性。它能幫助AI助手寫出更容易理解、更容易維護的程式碼。

具體做法：

• 只實現必要的功能：不要加入超出需求的額外功能。
• 避免不必要的抽象：對於只需要使用一次的程式碼，不要建立抽象層。
• 不要添加不必要的配置選項：除非你明確需要，否則不要讓程式碼過於可配置。
• 不要處理不可能發生的錯誤：簡化錯誤處理，只針對可能發生的情況進行處理。
• 如果可以用更少的程式碼完成，就簡化它：盡可能地簡化程式碼，讓它更易於理解。

測試方法：

問自己一個問題：「這個程式碼會讓資深工程師覺得過於複雜嗎？」如果答案是肯定的，那就簡化它！

舉例說明：

假設你要求AI助手寫一個功能，從資料庫中獲取使用者資訊。一個遵循「簡潔至上」原則的AI助手，會：

• 只獲取你要求的資料，例如使用者的姓名、Email和ID，而不是獲取所有資料。
• 直接使用資料庫查詢，而不是建立複雜的抽象層。
• 不添加不必要的配置選項，例如資料庫連線設定。

3. 精準修改 (Surgical Changes) 🔪

這個原則要求AI助手只修改它需要修改的部分，避免對其他程式碼造成不必要的影響。這能減少程式碼修改時引入錯誤的風險。

具體做法：

• 不要「改善」附近的程式碼：只修改你要求它修改的部分。
• 不要重構沒有問題的程式碼：除非你有明確的理由，否則不要修改現有的程式碼。
• 保持一致的風格：即使你不同意現有的程式碼風格，也要遵循它。
• 如果發現與任務無關的程式碼，但不要刪除它：只告知你發現了什麼，不要擅自刪除它。
• 只移除由你的修改造成的不再使用的程式碼：不要移除原本就存在但未使用程式碼，除非你被要求這樣做。

測試方法：

檢查每一行被修改的程式碼，確認它與你的要求直接相關。

舉例說明：

假設你要求AI助手修改一個函數，讓它能夠處理更多種類型的輸入。一個遵循「精準修改」原則的AI助手會：

• 只修改函數的邏輯，讓它能夠處理新的輸入類型。
• 不會修改函數的其他部分，例如變數名稱、註釋等。
• 不會修改與函數無關的程式碼。

4. 目標導向的執行 (Goal-Driven Execution) 🎯

這個原則將指令轉化為可驗證的目標，然後讓AI助手循環執行，直到達到目標為止。這能讓AI助手更自主地完成任務，並減少你不斷干預的次數。

具體做法：

• 將指令轉化為可驗證的目標：例如，不要說「添加驗證」，而是說「編寫測試來驗證無效輸入，然後讓測試通過」。
• 定義成功的標準：明確定義程式碼需要滿足的條件，例如「所有的測試都通過」。
• 使用迴圈：讓AI助手循環執行，直到達到成功的標準為止。

例子：

舉例說明：

假設你要求AI助手修復程式碼中的一個bug。一個遵循「目標導向的執行」原則的AI助手會：

1. 編寫一個測試，來重現這個bug。
2. 修改程式碼，使測試通過。
3. 驗證所有的測試都通過。

如何開始使用Karpathy風格的Claude程式碼撰寫指南？ 🚀

好的，那麼如何在你的專案中使用這個指南呢？ 你可以透過兩種方式實現：

方法A：使用Claude Code Plugin（推薦）

這是在Claude Code中安裝指南最簡單的方式。

1. 添加插件市場： 在Claude Code中輸入以下指令：

   /plugin marketplace add forrestchang/andrej-karpathy-skills
   

2. 安裝插件： 然後安裝插件：

   /plugin install andrej-karpathy-skills@karpathy-skills
   

   這會把指南安裝成Claude Code的插件，讓你在所有專案中使用這個技能。

方法B：CLAUDE.md文件 (每個專案都要設定)

你可以將指南直接加入到你的專案中。

1. 新建專案： 建立一個名為 CLAUDE.md 的檔案，然後從 GitHub 下載指南：

   curl -o CLAUDE.md https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md
   

2. 現有專案 (附加)： 如果你已經有了 CLAUDE.md 檔案，你可以將指南附加到檔案的底部：

   echo "" >> CLAUDE.md
   curl https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md >> CLAUDE.md
   

在使用之前，建議你熟悉 CLAUDE.md 檔案的內容，理解每個原則的細節。

怎樣知道它真的有效？ 🤔

當你開始使用這個指南時，你會注意到以下幾點變化：

• 更少的程式碼修改：AI助手只會修改你要求的內容。
• 更少的程式碼重寫：程式碼會更簡潔，避免了過度複雜化。
• 更多的澄清問題：AI助手會在寫程式碼之前向你提問，確保理解你的需求。
• 更乾淨的Pull Request：程式碼修改會更精簡，沒有不必要的修改和「改善」。

彈性運用，打造你的專屬指南！ 🛠️

這個指南可以與你的專案特定規則結合使用。 在你的 CLAUDE.md 中加入你專案的特定規則，例如：

## 專案特定指南

*   使用 TypeScript 嚴格模式
*   所有 API 端點都必須有測試
*   遵循 `src/utils/errors.ts` 中的錯誤處理模式

關於速度和風險的權衡 ⚖️

這個指南偏向於謹慎而非速度。 對於簡單的任務，例如簡單的拼寫錯誤修正或顯而易見的單行程式碼，你可以自行判斷，不一定需要遵循全部的原則。

目標是減少在非簡單任務上的代價高昂的錯誤，而不是減慢簡單任務的速度。

給台灣開發者的額外建議 💡

• 嘗試不同的prompt技巧：除了指南，你還可以嘗試不同的prompt技巧，來引導AI助手更好地理解你的需求。
• 定期檢視AI助手的程式碼：不要完全依賴AI助手，定期檢視它生成的程式碼，並進行修改和優化。
• 積極參與社群：和其他台灣開發者交流，分享你的經驗和技巧，共同提升使用AI寫程式碼的能力。

結語 🎉

Karpathy風格的Claude程式碼撰寫指南是一個強大的工具，能幫助你提升使用AI寫程式碼的效率和品質。 透過遵循這四個原則，你可以更好地控制AI助手，寫出更清晰、更簡潔、更可靠的程式碼。 趕快開始嘗試吧！ 🚀

祝你在程式碼世界中，玩得開心，寫得更棒！ 👍

參考閱讀

https://github.com/forrestchang/andrej-karpathy-skills

About the Author

n8n n8n

Administrator

View All Posts