一個(gè) CLAUDE.md 管住 Claude Codeandrej-karpathy-skills 的4條行為準(zhǔn)則實(shí)戰(zhàn)指南【免費(fèi)下載鏈接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathys observations on LLM coding pitfalls.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills凌晨一點(diǎn)你讓 Claude Code 修一個(gè)空指針異常它倒是改了但 diff 里順手優(yōu)化了旁邊三個(gè)函數(shù)的注釋、引號(hào)風(fēng)格和錯(cuò)誤處理。這種體驗(yàn)的根源是 Andrej Karpathy 對(duì) LLM 編碼陷阱的觀察而 andrej-karpathy-skills 把它落成了解決方案一個(gè) CLAUDE.md 指令文件用 4 條行為準(zhǔn)則約束編碼助手的行為邊界不引入框架、不改模型。這4個(gè)改壞代碼的癥狀你大概率都中過問題不在模型寫不出代碼而在它管不住自己的不確定性。默默做假設(shè)。你說加個(gè)導(dǎo)出數(shù)據(jù)功能它默認(rèn)全量導(dǎo)出、默認(rèn)文件格式、默認(rèn)字段清單不問一句就寫完了。過度工程。一個(gè)折扣計(jì)算函數(shù)它套上策略模式、抽象類、枚舉和配置對(duì)象200 行代碼干了 50 行的活。附帶損傷。讓你修 Bug它把不相關(guān)的注釋改進(jìn)了、格式重排了還加了一堆沒人要的類型標(biāo)注。無驗(yàn)證即交付。說修好了但沒有測(cè)試證明對(duì)錯(cuò)只能靠你肉眼檢查。andrej-karpathy-skills 就是對(duì)著這四個(gè)癥狀寫的一頁行為守則把怎么做事教給助手而不只是做什么。兩分鐘啟用 andrej-karpathy-skills插件或 CLAUDE.md 二選一最短路徑只有兩條按生效范圍選。方式一裝成 Claude Code 插件所有項(xiàng)目全局生效。在 Claude Code 里依次輸入/plugin marketplace add forrestchang/andrej-karpathy-skills /plugin install andrej-karpathy-skillskarpathy-skills裝完即生效之后每個(gè)會(huì)話自動(dòng)帶上這套準(zhǔn)則。方式二只給當(dāng)前項(xiàng)目用?？寺}庫后把 CLAUDE.md 的內(nèi)容放進(jìn)你項(xiàng)目根目錄已有同名文件就追加到末尾git clone https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skillsClaude Code 啟動(dòng)時(shí)會(huì)自動(dòng)讀取根目錄的 CLAUDE.md無需其他配置。如果你用 Cursor倉庫里已附帶一份規(guī)則文件.cursor/rules/karpathy-guidelines.mdc拷到目標(biāo)項(xiàng)目的同路徑下即可具體說明見倉庫的 CURSOR.md想作為可復(fù)用技能分發(fā)的話skills/karpathy-guidelines/SKILL.md是獨(dú)立版本。CLAUDE.md 的4條行為準(zhǔn)則逐條拆解這個(gè)文件沒有任何代碼和配置全部?jī)?nèi)容就是 4 條約束每條對(duì)準(zhǔn)一個(gè)癥狀。先說假設(shè)再動(dòng)手。為什么重要返工最多的工作都源于模型悄悄選了錯(cuò)誤的需求解釋并一路狂奔。準(zhǔn)則要求寫碼前把假設(shè)寫出來不確定就問存在多種解釋時(shí)并排列出不許默默挑一個(gè)。例子你說讓搜索變快它會(huì)先反問是響應(yīng)時(shí)間、吞吐量還是感知速度并給出各自的預(yù)估工作量而不是默默上緩存加異步。只寫最小必要的代碼。為什么重要過度抽象不是錯(cuò)是時(shí)機(jī)錯(cuò)——在需求還沒出現(xiàn)前就加復(fù)雜度。準(zhǔn)則設(shè)了硬清單不加工沒要求的功能、不為單次使用的代碼建抽象、不加沒被要求的靈活性寫了 200 行能壓到 50 行的重寫。檢驗(yàn)標(biāo)準(zhǔn)一句話資深工程師會(huì)說太復(fù)雜嗎只改必須改的只清理自己弄出來的亂子。為什么重要順手改進(jìn)讓 diff 無法審閱也讓回滾失去意義。規(guī)則是不改進(jìn)相鄰代碼、匹配現(xiàn)有風(fēng)格哪怕你自己寫法不同、發(fā)現(xiàn)無關(guān)死代碼只提及不刪除。檢驗(yàn)標(biāo)準(zhǔn)每一行改動(dòng)都能直接追溯到你的請(qǐng)求。給成功標(biāo)準(zhǔn)而不是步驟。為什么重要Karpathy 的原話是LLM 很擅長(zhǎng)循環(huán)直到達(dá)成目標(biāo)——你告訴它做什么它會(huì)飄告訴它達(dá)成標(biāo)準(zhǔn)是什么它會(huì)自己跑到終點(diǎn)。所以加校驗(yàn)要翻譯成為無效輸入寫測(cè)試再讓它通過多步驟任務(wù)必須先列出步驟 → 驗(yàn)證的簡(jiǎn)要計(jì)劃。弱標(biāo)準(zhǔn)讓它能跑會(huì)逼得你全程當(dāng)人肉測(cè)試員。實(shí)戰(zhàn)一次 Bug 修復(fù)里4條準(zhǔn)則如何接力假設(shè)你的評(píng)分功能有個(gè) Bug出現(xiàn)同分選手時(shí)榜單順序每次都變。啟用準(zhǔn)則后你說修一下分?jǐn)?shù)排序。沒有 CLAUDE.md 時(shí)它會(huì)直接重寫排序函數(shù)可能順帶重構(gòu)半條數(shù)據(jù)鏈路現(xiàn)在它換了個(gè)節(jié)奏。第一步它先復(fù)述癥狀并確認(rèn)預(yù)期行為準(zhǔn)則一同分順序不穩(wěn)定期望穩(wěn)定有序。第二步把任務(wù)翻譯成可驗(yàn)證目標(biāo)準(zhǔn)則四先寫一個(gè)測(cè)試用同分選手作為輸入斷言多次排序結(jié)果一致——先確認(rèn)測(cè)試失敗、復(fù)現(xiàn)出 Bug再動(dòng)手改。第三步改動(dòng)時(shí)只給排序鍵加了一個(gè)同分時(shí)的姓名 tie-breaker準(zhǔn)則三沒動(dòng)注釋、沒動(dòng)引號(hào)、沒引入比較器工具類因?yàn)樗袛喾€(wěn)定排序足夠準(zhǔn)則二。最后跑一遍既有測(cè)試確認(rèn)無回歸。整個(gè)交付是一個(gè)小提交一個(gè)復(fù)現(xiàn)測(cè)試加幾行排序邏輯diff 一眼讀完。謹(jǐn)慎優(yōu)先的代價(jià)3種場(chǎng)景別硬套這套準(zhǔn)則明確偏向謹(jǐn)慎而非速度所以它也有適用邊界。瑣碎任務(wù)直接跳過全套流程。改錯(cuò)別字、加一行明顯該加的代碼走完整的提問-驗(yàn)證流程只會(huì)讓你覺得它變慢了。文件開頭就聲明了這個(gè)權(quán)衡非瑣碎任務(wù)才值得完整嚴(yán)謹(jǐn)。別指望它替你審架構(gòu)。準(zhǔn)則約束的是行為不替代能力涉及架構(gòu)級(jí)的取舍最終拍板還得是人。合并而不是替換。它設(shè)計(jì)上就是給現(xiàn)有 CLAUDE.md 追加用的你可以自己加一節(jié)項(xiàng)目規(guī)則比如所有 API 端點(diǎn)必須有測(cè)試但別指望這一頁紙修掉模型所有的毛病。判斷它是否生效也有信號(hào)diff 里無關(guān)變更變少、澄清問題出現(xiàn)在實(shí)現(xiàn)之前而不是犯錯(cuò)之后、代碼第一次就是簡(jiǎn)單的。andrej-karpathy-skills 的全部?jī)r(jià)值就是花兩分鐘教會(huì)助手先問、少做、改準(zhǔn)、驗(yàn)證四個(gè)習(xí)慣把代價(jià)高昂的返工變成便宜的一句澄清。下一步建議把它放進(jìn)你最近最被它坑的項(xiàng)目盯一周的 diff你會(huì)直觀看到差別?！久赓M(fèi)下載鏈接】andrej-karpathy-skillsA single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathys observations on LLM coding pitfalls.項(xiàng)目地址: https://gitcode.com/GitHub_Trending/an/andrej-karpathy-skills創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考