 CLAUDE.md 管住 Claude Code:andrej-karpathy-skills 的4條行為準(zhǔn)則實(shí)戰(zhàn)指南)
一個(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è)改壞代碼的癥狀你大概率都中過(guò)問(wèn)題不在模型寫(xiě)不出代碼而在它管不住自己的不確定性。默默做假設(shè)。你說(shuō)加個(gè)導(dǎo)出數(shù)據(jù)功能它默認(rèn)全量導(dǎo)出、默認(rèn)文件格式、默認(rèn)字段清單不問(wèn)一句就寫(xiě)完了。過(guò)度工程。一個(gè)折扣計(jì)算函數(shù)它套上策略模式、抽象類(lèi)、枚舉和配置對(duì)象200 行代碼干了 50 行的活。附帶損傷。讓你修 Bug它把不相關(guān)的注釋改進(jìn)了、格式重排了還加了一堆沒(méi)人要的類(lèi)型標(biāo)注。無(wú)驗(yàn)證即交付。說(shuō)修好了但沒(méi)有測(cè)試證明對(duì)錯(cuò)只能靠你肉眼檢查。andrej-karpathy-skills 就是對(duì)著這四個(gè)癥狀寫(xiě)的一頁(yè)行為守則把怎么做事教給助手而不只是做什么。兩分鐘啟用 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)目用??寺}(cāng)庫(kù)后把 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無(wú)需其他配置。如果你用 Cursor倉(cāng)庫(kù)里已附帶一份規(guī)則文件.cursor/rules/karpathy-guidelines.mdc拷到目標(biāo)項(xiàng)目的同路徑下即可具體說(shuō)明見(jiàn)倉(cāng)庫(kù)的 CURSOR.md想作為可復(fù)用技能分發(fā)的話skills/karpathy-guidelines/SKILL.md是獨(dú)立版本。CLAUDE.md 的4條行為準(zhǔn)則逐條拆解這個(gè)文件沒(méi)有任何代碼和配置全部?jī)?nèi)容就是 4 條約束每條對(duì)準(zhǔn)一個(gè)癥狀。先說(shuō)假設(shè)再動(dòng)手。為什么重要返工最多的工作都源于模型悄悄選了錯(cuò)誤的需求解釋并一路狂奔。準(zhǔn)則要求寫(xiě)碼前把假設(shè)寫(xiě)出來(lái)不確定就問(wèn)存在多種解釋時(shí)并排列出不許默默挑一個(gè)。例子你說(shuō)讓搜索變快它會(huì)先反問(wèn)是響應(yīng)時(shí)間、吞吐量還是感知速度并給出各自的預(yù)估工作量而不是默默上緩存加異步。只寫(xiě)最小必要的代碼。為什么重要過(guò)度抽象不是錯(cuò)是時(shí)機(jī)錯(cuò)——在需求還沒(méi)出現(xiàn)前就加復(fù)雜度。準(zhǔn)則設(shè)了硬清單不加工沒(méi)要求的功能、不為單次使用的代碼建抽象、不加沒(méi)被要求的靈活性寫(xiě)了 200 行能壓到 50 行的重寫(xiě)。檢驗(yàn)標(biāo)準(zhǔn)一句話資深工程師會(huì)說(shuō)太復(fù)雜嗎只改必須改的只清理自己弄出來(lái)的亂子。為什么重要順手改進(jìn)讓 diff 無(wú)法審閱也讓回滾失去意義。規(guī)則是不改進(jìn)相鄰代碼、匹配現(xiàn)有風(fēng)格哪怕你自己寫(xiě)法不同、發(fā)現(xiàn)無(wú)關(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)要翻譯成為無(wú)效輸入寫(xiě)測(cè)試再讓它通過(guò)多步驟任務(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)則后你說(shuō)修一下分?jǐn)?shù)排序。沒(méi)有 CLAUDE.md 時(shí)它會(huì)直接重寫(xiě)排序函數(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)則四先寫(xiě)一個(gè)測(cè)試用同分選手作為輸入斷言多次排序結(jié)果一致——先確認(rèn)測(cè)試失敗、復(fù)現(xiàn)出 Bug再動(dòng)手改。第三步改動(dòng)時(shí)只給排序鍵加了一個(gè)同分時(shí)的姓名 tie-breaker準(zhǔn)則三沒(méi)動(dòng)注釋、沒(méi)動(dòng)引號(hào)、沒(méi)引入比較器工具類(lèi)因?yàn)樗袛喾€(wěn)定排序足夠準(zhǔn)則二。最后跑一遍既有測(cè)試確認(rèn)無(wú)回歸。整個(gè)交付是一個(gè)小提交一個(gè)復(fù)現(xiàn)測(cè)試加幾行排序邏輯diff 一眼讀完。謹(jǐn)慎優(yōu)先的代價(jià)3種場(chǎng)景別硬套這套準(zhǔn)則明確偏向謹(jǐn)慎而非速度所以它也有適用邊界?,嵥槿蝿?wù)直接跳過(guò)全套流程。改錯(cuò)別字、加一行明顯該加的代碼走完整的提問(wèn)-驗(yàn)證流程只會(huì)讓你覺(jué)得它變慢了。文件開(kāi)頭就聲明了這個(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è)試但別指望這一頁(yè)紙修掉模型所有的毛病。判斷它是否生效也有信號(hào)diff 里無(wú)關(guān)變更變少、澄清問(wèn)題出現(xiàn)在實(shí)現(xiàn)之前而不是犯錯(cuò)之后、代碼第一次就是簡(jiǎn)單的。andrej-karpathy-skills 的全部?jī)r(jià)值就是花兩分鐘教會(huì)助手先問(wèn)、少做、改準(zhǔn)、驗(yàn)證四個(gè)習(xí)慣把代價(jià)高昂的返工變成便宜的一句澄清。下一步建議把它放進(jìn)你最近最被它坑的項(xiàng)目盯一周的 diff你會(huì)直觀看到差別。【免費(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),僅供參考