
AI 改的代碼總要多返工三遍一份 CLAUDE.md 把毛病一條條堵上了【免費下載鏈接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathys observations on LLM coding pitfalls.項目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills讓 AI 修一個空郵箱崩潰的 bugdiff 里卻混進引號統一、類型注解、甚至沒人要的用戶名校驗——這種手欠式改碼用過 AI 編碼助手的人都見過。開源項目 andrej-karpathy-skills 就是沖著這些毛病來的它把一組針對 LLM 編碼行為的問題準則壓縮進一份 CLAUDE.md 文件不動模型能力只改它干活時的習慣。一次真實翻車修 bug 修出三份禮物EXAMPLES.md 里記錄了一個很典型的場景用戶只說修一下空郵箱會讓校驗器崩潰的 bug。AI 交回的卻是整個校驗函數的大改——注釋被重寫、docstring 被加上、郵箱校驗被順手加強還附贈一套沒人要求的用戶名校驗規則用戶名太短必須是字母數字。另一個案例更直觀只要求在上傳函數里加日志結果引號風格全被換成雙引號、每個參數加了類型注解、空白重新排版連布爾返回邏輯都被改寫了。問題不在于 AI 的代碼錯了而在于你很難逐行說清這行改動是哪句需求要求的項目做的事把行為約束寫進一份文件作者把 Andrej Karpathy 公開吐槽過的 LLM 編碼通病整理進了這份 CLAUDE.mdskills/karpathy-guidelines/SKILL.md 是同一套內容做成 Claude Code 插件的形態。Karpathy 的原話很犀利模型會代你做錯誤假設然后不假思索地執行100 行能搞定的事情非要寫成 1000 行臃腫架構甚至會改動或刪除自己并不充分理解、與任務無關的代碼和注釋。項目的回答不是教 AI 新招式而是逐條改寫它的幾個默認習慣AI 的默認習慣約束后的行為對應來源對模糊需求默默選一種解釋直接干動手前列出假設不確定就問有多種解讀時全部擺出來讓用戶選CLAUDE.md 的 Think Before Coding給一次性邏輯套策略模式、配置對象寫了 200 行而 50 行就夠就重寫提交前自問資深工程師會覺得過度復雜嗎CLAUDE.md 的 Simplicity First改代碼時順手動相鄰代碼、注釋、格式每一行改動都應能追溯到用戶請求只清理自己改動產生的孤兒代碼CLAUDE.md 的 Surgical Changes用讓它能跑這種模糊標準收尾修 bug轉成先寫一個能復現它的測試再讓它通過多步計劃每步帶一條可驗證的驗收項CLAUDE.md 的 Goal-Driven Execution這不是代碼風格建議清單而是一套 AI 在每次任務里要逐條自檢的行為規則。同題對比一個折扣函數值多少行 ??EXAMPLES.md 用最直接的例子說明輸出差異。同一句需求加一個計算折扣的函數默認行為是抽象類 DiscountStrategy、兩個實現類、一個配置 dataclass、一個計算器類約 40 行定義調用時還要 30 多行初始化代碼。約束之后的版本是 3 行一個函數金額乘百分比除以 100完事。要注意長的那版并不錯它用的都是教科書式的設計模式。問題出在時機復雜度在需求出現之前就被加進來了。文檔里保存用戶偏好到數據庫的例子同理——默認版本附帶緩存、校驗器、合并開關、變更通知約束后只剩一個函數和一條 SQL。什么時候加緩存、什么時候加校驗等性能真的需要、臟數據真的出現時再說。多步任務的差距體現在計劃上。給 API 加限流不再是把 Redis、多策略、監控塞進一個 300 行的提交而是拆成四步從最簡單的單端點內存限流開始每一步掛著可驗證的驗收項比如curl 該端點 11 次第 11 次返回 429。標準清晰了AI 才能自己循環驗證不用你步步盯。安裝步驟Claude Code 與 Cursor 各怎么接 三條路徑按需選一條Claude Code 插件項目推薦在 Claude Code 里先執行/plugin marketplace add forrestchang/andrej-karpathy-skills再執行/plugin install andrej-karpathy-skillskarpathy-skills裝完在所有項目中生效。按項目配 CLAUDE.mdgit clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills后把 CLAUDE.md 拷進目標項目根目錄即可項目里已有 CLAUDE.md 就直接把內容追加進去。這份文件本來就是為合并設計的之后可以加一節項目特定指南寫上你項目自己的規則。Cursor把.cursor/rules/karpathy-guidelines.mdc拷進目標項目的.cursor/rules/目錄細節見 CURSOR.md。適用邊界與效果自查什么時候別上這套文件開頭就寫明了取舍這套準則整體偏向謹慎而非速度。改錯別字、顯而易見的一行修改不必走完整流程用判斷力即可——目標是減少非平凡工作里的高成本失誤不是拖慢簡單任務。有沒有生效可以對照項目自己給出的信號自查diff 里只剩你要求的改動順手改進消失了澄清性問題出現在動手之前而不是搞砸之后代碼第一次就寫得簡單不再因過度復雜而重寫PR 干凈沒有夾帶的格式化和順路重構前兩條如果在前幾個任務里就出現說明準則已經起作用。下一步很簡單裝插件或把 CLAUDE.md 拷進一個真實項目然后翻一遍 EXAMPLES.md 里成對的前后案例——那是理解這套準則到底在約束什么的最快路徑。【免費下載鏈接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathys observations on LLM coding pitfalls.項目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills創作聲明:本文部分內容由AI輔助生成(AIGC),僅供參考