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