矩：技能包本地化改造時(shí)最容易犯的四個(gè)錯(cuò))
別照抄 Karpathy 的規(guī)矩技能包本地化改造時(shí)最容易犯的四個(gè)錯(cuò)【免費(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-skillsAndrej Karpathy 關(guān)于 LLM 編碼缺陷的幾條觀(guān)察在 2026 年幾乎成了 AI 編程圈的公共常識(shí)模型會(huì)替你做出錯(cuò)誤假設(shè)然后悶頭執(zhí)行、會(huì)把 100 行的需求實(shí)現(xiàn)成 1000 行的抽象堆砌、會(huì)順手改掉它沒(méi)看懂但無(wú)關(guān)緊要的注釋還會(huì)在沒(méi)有明確成功標(biāo)準(zhǔn)的情況下盲目循環(huán)。圍繞這些觀(guān)察andrej-karpathy-skills這個(gè)倉(cāng)庫(kù)給出了一份極簡(jiǎn)的答案——一個(gè)CLAUDE.md文件、四條行為準(zhǔn)則。社區(qū)熱度也一路走高掘金上有《一天一個(gè)開(kāi)源項(xiàng)目》專(zhuān)門(mén)拆解它媒體以專(zhuān)治 AI 瞎寫(xiě)、失憶、造屎山來(lái)概括其價(jià)值2026 年 8 月的 GitHub Trending 月度觀(guān)察中Agent Skills 更是被列為當(dāng)月開(kāi)源圈的關(guān)鍵詞之一。但熱度高不意味著能照抄。恰恰相反這個(gè)倉(cāng)庫(kù)的所有文檔里都寫(xiě)著一句常被忽略的前提——Merge with project-specific instructions as needed按需與項(xiàng)目特定指令合并。這篇文章不重復(fù)講這四條原則是什么而是結(jié)合倉(cāng)庫(kù)源碼本身拆解本地化改造這個(gè)動(dòng)作里最容易犯的四個(gè)錯(cuò)以及一份可落地的檢查清單。一、先搞清楚原版規(guī)矩是為誰(shuí)的代碼庫(kù)寫(xiě)的先看這個(gè)倉(cāng)庫(kù)的真實(shí)結(jié)構(gòu)。它不是一個(gè)技能框架而是把一套行為準(zhǔn)則同時(shí)打包成了三份載體CLAUDE.mdClaude Code 按項(xiàng)目讀取的根指令文件skills/karpathy-guidelines/SKILL.md帶 YAML frontmatter 的可復(fù)用技能包通過(guò) .claude-plugin/plugin.json 掛載.cursor/rules/karpathy-guidelines.mdcCursor 項(xiàng)目規(guī)則alwaysApply: true。三份文件的正文幾乎逐字一致這是倉(cāng)庫(kù)作者刻意為之的單源多端設(shè)計(jì)——CURSOR.md 里明確要求貢獻(xiàn)者改動(dòng)四條原則時(shí)必須三份同步。也就是說(shuō)原版規(guī)矩的設(shè)計(jì)目標(biāo)是跨工具一致而不是貼合某個(gè)具體代碼庫(kù)。這也是它不適合直接照抄的根本原因原版描述的是一個(gè)通用場(chǎng)景下的理想 Agent而你面對(duì)的是一個(gè)有歷史包袱、有既有風(fēng)格、有真實(shí)測(cè)試基建的倉(cāng)庫(kù)。Karpathy 本人在訪(fǎng)談里也反復(fù)強(qiáng)調(diào)這一點(diǎn)——他把現(xiàn)在的 AI 編碼助手定位成能力出眾但還不穩(wěn)定的實(shí)習(xí)生實(shí)習(xí)生可以負(fù)責(zé)底層實(shí)現(xiàn)細(xì)節(jié)但規(guī)格設(shè)計(jì)、品味、頂層架構(gòu)決策必須由人來(lái)定。如果連規(guī)矩本身都原封不動(dòng)地交給模型就等于放棄了最不該外包的那部分判斷。倉(cāng)庫(kù)自己在 CLAUDE.md 開(kāi)頭就埋了一條權(quán)衡聲明Tradeoff:These guidelines bias toward caution over speed. For trivial tasks, use judgment.偏向謹(jǐn)慎而非速度是一個(gè)權(quán)衡取向不是一個(gè)普適默認(rèn)值。你的代碼庫(kù)如果是一個(gè)快速迭代的腳本倉(cāng)庫(kù)或是一個(gè)多人協(xié)作、review 極嚴(yán)的微服務(wù)倉(cāng)庫(kù)這條取向的權(quán)重應(yīng)該是完全不同的。不調(diào)整這條基線(xiàn)就是所有本地化錯(cuò)誤的源頭。二、四個(gè)典型改造錯(cuò)誤與后果錯(cuò)誤一把不確定就問(wèn)從兜底條款升格為默認(rèn)協(xié)議原版第一條原則Think Before Coding的原文是- State your assumptions explicitly. If uncertain, ask. - If multiple interpretations exist, present them - dont pick silently. - If something is unclear, stop. Name whats confusing. Ask.注意原文的措辭順序先明確陳述假設(shè)再呈現(xiàn)多種解釋最后才是停下來(lái)問(wèn)。這是一條兜底條款——只有當(dāng)歧義真實(shí)存在、且錯(cuò)誤猜測(cè)的代價(jià)大于澄清成本時(shí)才觸發(fā)。但很多人在本地化時(shí)會(huì)把最后一句刪掉前置條件直接改寫(xiě)成所有任務(wù)開(kāi)始前先列出問(wèn)題清單甚至寫(xiě)進(jìn)系統(tǒng)提示詞強(qiáng)制每次開(kāi)工先提問(wèn)。后果是可以量化的倉(cāng)庫(kù)在第四條原則里自己寫(xiě)了判斷標(biāo)準(zhǔn)——Strong success criteria let you loop independently. Weak criteria (make it work) require constant clarification.強(qiáng)成功標(biāo)準(zhǔn)讓模型獨(dú)立循環(huán)弱標(biāo)準(zhǔn)則需要不斷澄清。當(dāng)澄清變成默認(rèn)協(xié)議每一次任務(wù)都被迫先消耗一輪往返原本一分鐘能完成的瑣碎改動(dòng)被拖成多輪對(duì)話(huà)吞吐量直接腰斬。這也正是 SKILL.md 里那句For trivial tasks, use judgment想防的事。正確的本地化姿勢(shì)保留先陳述假設(shè)和呈現(xiàn)權(quán)衡這兩個(gè)低成本的主動(dòng)行為把提問(wèn)嚴(yán)格限定在假設(shè)被證偽會(huì)破壞正確性的場(chǎng)景同時(shí)為項(xiàng)目維護(hù)一份已知約定清單命名規(guī)范、分層約定、異常策略讓模型先查約定、再判斷是否需要問(wèn)。錯(cuò)誤二拿簡(jiǎn)潔優(yōu)先當(dāng)推倒重寫(xiě)的許可證第二條原則Simplicity First里有一句極具煽動(dòng)性的條文If you write 200 lines and it could be 50, rewrite it.這句話(huà)在原語(yǔ)境里約束的是模型自己剛寫(xiě)出的新代碼——寫(xiě)的時(shí)候發(fā)現(xiàn)膨脹了就重寫(xiě)。但本地化改造時(shí)最常見(jiàn)的誤讀是把它當(dāng)成對(duì)存量代碼的審判標(biāo)準(zhǔn)——這段舊代碼 200 行明顯能精簡(jiǎn)到 50 行重寫(xiě)它。這就和第三條原則Surgical Changes直接打架了。后者寫(xiě)得很死- Dont refactor things that arent broken. - Match existing style, even if youd do it differently. - If you notice unrelated dead code, mention it - dont delete it.不要重構(gòu)沒(méi)壞的東西即使你更喜歡別的寫(xiě)法也要匹配現(xiàn)有風(fēng)格——EXAMPLES.md 里那張反模式對(duì)照表把這個(gè)沖突講得更直白LLM 最常見(jiàn)的錯(cuò)誤恰恰是為了修一個(gè) bug 順手改進(jìn)了相鄰代碼、加了沒(méi)人要的用戶(hù)名校驗(yàn)、改了注釋和 docstring。一個(gè)把200 行改 50 行奉為圭臬的規(guī)則文件等于給這種順帶重構(gòu)發(fā)了許可證。后果在 diff 審查時(shí)爆發(fā)無(wú)關(guān)改動(dòng)淹沒(méi)真正的修復(fù)reviewer 無(wú)法快速定位變更意圖PR 體量膨脹甚至引入回歸。Karpathy 自己在訪(fǎng)談里也承認(rèn)他想讓 LLM 幫他進(jìn)一步精簡(jiǎn) nanoGPT 的代碼模型的表現(xiàn)非常糟糕——簡(jiǎn)化是最難被自動(dòng)化引導(dǎo)的工程行為之一它依賴(lài)對(duì)業(yè)務(wù)語(yǔ)義的完整理解而這恰恰是實(shí)習(xí)生最欠缺的。正確的本地化姿勢(shì)把重寫(xiě)條款的適用范圍限定為本次任務(wù)新產(chǎn)生的代碼并補(bǔ)一條硬規(guī)則——任何對(duì)存量代碼的結(jié)構(gòu)性精簡(jiǎn)必須先單獨(dú)提出并等待確認(rèn)不得與功能改動(dòng)混在同一個(gè)提交里。錯(cuò)誤三抽掉驗(yàn)證回路只留目標(biāo)口號(hào)四條原則里Goal-Driven Execution是唯一自帶閉環(huán)機(jī)制的把指令式任務(wù)轉(zhuǎn)化為可驗(yàn)證目標(biāo)例如Add validation → Write tests for invalid inputs, then make them pass Fix the bug → Write a test that reproduces it, then make it pass并且為多步任務(wù)規(guī)定了顯式的驗(yàn)證格式1. [Step] → verify: [check] 2. [Step] → verify: [check] 3. [Step] → verify: [check]這套機(jī)制的成立前提是你的倉(cāng)庫(kù)存在可執(zhí)行的驗(yàn)證手段。它默認(rèn)你有測(cè)試框架、能寫(xiě)一個(gè)復(fù)現(xiàn) bug 的測(cè)試然后讓它通過(guò)。但大量存量項(xiàng)目根本沒(méi)有測(cè)試基建——老代碼、腳本庫(kù)、一次性任務(wù)倉(cāng)庫(kù)連pytest都沒(méi)有。在這種倉(cāng)庫(kù)里照抄這條規(guī)則得到的結(jié)果是模型每次都輸出verify: test passes這樣的空殼檢查項(xiàng)驗(yàn)證回路變成裝飾性文本規(guī)則名存實(shí)亡。更隱蔽的后果是偽可驗(yàn)證沒(méi)有測(cè)試兜底時(shí)模型會(huì)把構(gòu)建成功或編譯通過(guò)誤當(dāng)成業(yè)務(wù)正確的證據(jù)Karpathy 訪(fǎng)談里談的可驗(yàn)證性概念正是關(guān)鍵——模型能力呈鋸齒狀只有在結(jié)果可驗(yàn)證的領(lǐng)域它才可靠。本地化時(shí)如果不為每條規(guī)則掛上項(xiàng)目里真實(shí)存在的驗(yàn)證鉤子就等于把規(guī)則建立在了模型最不可靠的地基上。正確的本地化姿勢(shì)為每條成功標(biāo)準(zhǔn)指定本項(xiàng)目實(shí)際可用的驗(yàn)證手段——有測(cè)試就用測(cè)試沒(méi)有測(cè)試就退化為明確的可觀(guān)察斷言如手動(dòng)跑通某條命令、檢查特定輸出、對(duì)照 checklist 逐項(xiàng)勾選如果連斷言都做不了這條任務(wù)就不該被交給 Agent 獨(dú)立循環(huán)。錯(cuò)誤四整包粘貼三份規(guī)則互相打架這個(gè)倉(cāng)庫(kù)最大的坑藏在安裝方式里。README 提供了三種入口Claude Code 插件市場(chǎng)/plugin install andrej-karpathy-skillskarpathy-skills、按項(xiàng)目的curl -o CLAUDE.md、以及 Cursor 的.cursor/rules/項(xiàng)目規(guī)則。很多人的本地化改造就是把這三種方式各來(lái)一遍項(xiàng)目里同時(shí)出現(xiàn)了一份插件注入的SKILL.md、一份追加的CLAUDE.md、一份.mdc規(guī)則——三份內(nèi)容一致但生效優(yōu)先級(jí)和讀取機(jī)制完全不同。CURSOR.md 里其實(shí)寫(xiě)了一句關(guān)鍵提示Cursor 默認(rèn)不讀.claude-plugin/和CLAUDE.md反之 Claude Code 也不讀.cursor/rules/。如果你在 Cursor 項(xiàng)目里只粘貼了CLAUDE.md整個(gè)規(guī)則對(duì) Cursor 就是透明的——你以為裝上了其實(shí)一條都沒(méi)生效。反過(guò)來(lái)三份都放但內(nèi)容各自改了一版模型在不同工具里拿到的行為準(zhǔn)則不一致輸出風(fēng)格來(lái)回漂移比不裝更糟。更深一層的沖突來(lái)自合并這一步被跳過(guò)。README 的 Customization 章節(jié)給出了標(biāo)準(zhǔn)姿勢(shì)——在現(xiàn)有CLAUDE.md里追加項(xiàng)目特定指南小節(jié)例如使用 TypeScript 嚴(yán)格模式所有 API 端點(diǎn)必須有測(cè)試遵循src/utils/errors.ts的錯(cuò)誤處理模式。原版規(guī)則的設(shè)計(jì)意圖是作為通用層與項(xiàng)目層疊加而不是整文件覆蓋。直接整包粘貼會(huì)帶來(lái)一類(lèi)典型事故項(xiàng)目約定匹配現(xiàn)有風(fēng)格規(guī)則卻要求如果 200 行能寫(xiě)成 50 行就重寫(xiě)——兩條指令同時(shí)存在時(shí)模型只能隨機(jī)選一條執(zhí)行。正確的本地化姿勢(shì)確立一份源文件 按工具生成三份副本的維護(hù)模型倉(cāng)庫(kù)作者在 CURSOR.md 里就是這么要求貢獻(xiàn)者的項(xiàng)目層約定以追加小節(jié)的方式注入并給規(guī)則標(biāo)注優(yōu)先級(jí)——項(xiàng)目特定指南優(yōu)先于通用指南沖突時(shí)以項(xiàng)目特定指南為準(zhǔn)。三、一份本地化改造檢查清單結(jié)合上面的四個(gè)錯(cuò)誤本地化一份 Karpathy 風(fēng)格技能包時(shí)建議逐項(xiàng)對(duì)照保留權(quán)衡聲明并為本倉(cāng)庫(kù)重寫(xiě)它明確寫(xiě)下本倉(cāng)庫(kù)哪些場(chǎng)景要求謹(jǐn)慎、哪些場(chǎng)景允許快速放行不要沿用原文的通用取向。給提問(wèn)加觸發(fā)條件澄清只發(fā)生在假設(shè)被證偽代價(jià)高的場(chǎng)景為項(xiàng)目維護(hù)約定清單讓模型先查后問(wèn)。重寫(xiě)簡(jiǎn)潔優(yōu)先的作用域明確200 行改 50 行只適用于本次任務(wù)新產(chǎn)生的代碼存量重構(gòu)必須單獨(dú)提 PR。為每條成功標(biāo)準(zhǔn)掛上真實(shí)的驗(yàn)證鉤子測(cè)試、命令、斷言、人工 checklist至少占一樣沒(méi)有驗(yàn)證手段的任務(wù)不承諾獨(dú)立循環(huán)。統(tǒng)一維護(hù)入口規(guī)則正文只維護(hù)一份源文件建議 skills/karpathy-guidelines/SKILL.mdCLAUDE.md、.mdc、插件配置均由此生成杜絕三份漂移。聲明沖突仲裁規(guī)則項(xiàng)目特定指南與通用規(guī)則沖突時(shí)項(xiàng)目特定指南優(yōu)先并把這個(gè)仲裁條款寫(xiě)進(jìn)文件頭部。對(duì)照生效信號(hào)驗(yàn)收倉(cāng)庫(kù)在 How to Know Its Working 里給了四組可觀(guān)察信號(hào)——diff 里無(wú)關(guān)改動(dòng)變少、因過(guò)度復(fù)雜導(dǎo)致的重寫(xiě)變少、澄清問(wèn)題發(fā)生在實(shí)現(xiàn)之前、PR 干凈且無(wú)順帶重構(gòu)。改造后應(yīng)能以這四項(xiàng)做回歸驗(yàn)收。四、判斷本地化成敗的最終標(biāo)準(zhǔn)README.md 最后一段其實(shí)已經(jīng)給出了檢驗(yàn)本地化的終極標(biāo)尺這些規(guī)則起作用的標(biāo)志不是模型記住了多少條文而是代價(jià)發(fā)生的時(shí)機(jī)是否前移——澄清發(fā)生在實(shí)現(xiàn)之前而不是犯錯(cuò)之后diff 里只出現(xiàn)被請(qǐng)求的改動(dòng)重寫(xiě)不是因?yàn)檫^(guò)度復(fù)雜而是因?yàn)樾枨笞兓Q句話(huà)說(shuō)Karpathy 的規(guī)矩本質(zhì)上是把人管理實(shí)習(xí)生的方式顯式化給出成功標(biāo)準(zhǔn)、明確作用邊界、要求及時(shí)匯報(bào)困惑。本地化改造做得對(duì)不對(duì)不看它被抄得多完整而看它是否在你的倉(cāng)庫(kù)里真的改變了那些代價(jià)的分布。照抄只會(huì)得到一個(gè)行為乖張的實(shí)習(xí)生改對(duì)了你才擁有一個(gè)知道什么時(shí)候該問(wèn)、什么時(shí)候該動(dòng)手的穩(wěn)定協(xié)作者。畢竟就像 Karpathy 在訪(fǎng)談里反復(fù)引用的那句話(huà)你可以外包你的思考但你無(wú)法外包你的理解。規(guī)則文件可以外包給模型執(zhí)行但為你的代碼庫(kù)裁剪規(guī)則這件事理解必須留在你這邊?！久赓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），僅供參考 別照抄 Karpathy 的規(guī)矩：技能包本地化改造時(shí)最容易犯的四個(gè)錯(cuò)
別照抄 Karpathy 的規(guī)矩技能包本地化改造時(shí)最容易犯的四個(gè)錯(cuò)【免費(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-skillsAndrej Karpathy 關(guān)于 LLM 編碼缺陷的幾條觀(guān)察在 2026 年幾乎成了 AI 編程圈的公共常識(shí)模型會(huì)替你做出錯(cuò)誤假設(shè)然后悶頭執(zhí)行、會(huì)把 100 行的需求實(shí)現(xiàn)成 1000 行的抽象堆砌、會(huì)順手改掉它沒(méi)看懂但無(wú)關(guān)緊要的注釋還會(huì)在沒(méi)有明確成功標(biāo)準(zhǔn)的情況下盲目循環(huán)。圍繞這些觀(guān)察andrej-karpathy-skills這個(gè)倉(cāng)庫(kù)給出了一份極簡(jiǎn)的答案——一個(gè)CLAUDE.md文件、四條行為準(zhǔn)則。社區(qū)熱度也一路走高掘金上有《一天一個(gè)開(kāi)源項(xiàng)目》專(zhuān)門(mén)拆解它媒體以專(zhuān)治 AI 瞎寫(xiě)、失憶、造屎山來(lái)概括其價(jià)值2026 年 8 月的 GitHub Trending 月度觀(guān)察中Agent Skills 更是被列為當(dāng)月開(kāi)源圈的關(guān)鍵詞之一。但熱度高不意味著能照抄。恰恰相反這個(gè)倉(cāng)庫(kù)的所有文檔里都寫(xiě)著一句常被忽略的前提——Merge with project-specific instructions as needed按需與項(xiàng)目特定指令合并。這篇文章不重復(fù)講這四條原則是什么而是結(jié)合倉(cāng)庫(kù)源碼本身拆解本地化改造這個(gè)動(dòng)作里最容易犯的四個(gè)錯(cuò)以及一份可落地的檢查清單。一、先搞清楚原版規(guī)矩是為誰(shuí)的代碼庫(kù)寫(xiě)的先看這個(gè)倉(cāng)庫(kù)的真實(shí)結(jié)構(gòu)。它不是一個(gè)技能框架而是把一套行為準(zhǔn)則同時(shí)打包成了三份載體CLAUDE.mdClaude Code 按項(xiàng)目讀取的根指令文件skills/karpathy-guidelines/SKILL.md帶 YAML frontmatter 的可復(fù)用技能包通過(guò) .claude-plugin/plugin.json 掛載.cursor/rules/karpathy-guidelines.mdcCursor 項(xiàng)目規(guī)則alwaysApply: true。三份文件的正文幾乎逐字一致這是倉(cāng)庫(kù)作者刻意為之的單源多端設(shè)計(jì)——CURSOR.md 里明確要求貢獻(xiàn)者改動(dòng)四條原則時(shí)必須三份同步。也就是說(shuō)原版規(guī)矩的設(shè)計(jì)目標(biāo)是跨工具一致而不是貼合某個(gè)具體代碼庫(kù)。這也是它不適合直接照抄的根本原因原版描述的是一個(gè)通用場(chǎng)景下的理想 Agent而你面對(duì)的是一個(gè)有歷史包袱、有既有風(fēng)格、有真實(shí)測(cè)試基建的倉(cāng)庫(kù)。Karpathy 本人在訪(fǎng)談里也反復(fù)強(qiáng)調(diào)這一點(diǎn)——他把現(xiàn)在的 AI 編碼助手定位成能力出眾但還不穩(wěn)定的實(shí)習(xí)生實(shí)習(xí)生可以負(fù)責(zé)底層實(shí)現(xiàn)細(xì)節(jié)但規(guī)格設(shè)計(jì)、品味、頂層架構(gòu)決策必須由人來(lái)定。如果連規(guī)矩本身都原封不動(dòng)地交給模型就等于放棄了最不該外包的那部分判斷。倉(cāng)庫(kù)自己在 CLAUDE.md 開(kāi)頭就埋了一條權(quán)衡聲明Tradeoff:These guidelines bias toward caution over speed. For trivial tasks, use judgment.偏向謹(jǐn)慎而非速度是一個(gè)權(quán)衡取向不是一個(gè)普適默認(rèn)值。你的代碼庫(kù)如果是一個(gè)快速迭代的腳本倉(cāng)庫(kù)或是一個(gè)多人協(xié)作、review 極嚴(yán)的微服務(wù)倉(cāng)庫(kù)這條取向的權(quán)重應(yīng)該是完全不同的。不調(diào)整這條基線(xiàn)就是所有本地化錯(cuò)誤的源頭。二、四個(gè)典型改造錯(cuò)誤與后果錯(cuò)誤一把不確定就問(wèn)從兜底條款升格為默認(rèn)協(xié)議原版第一條原則Think Before Coding的原文是- State your assumptions explicitly. If uncertain, ask. - If multiple interpretations exist, present them - dont pick silently. - If something is unclear, stop. Name whats confusing. Ask.注意原文的措辭順序先明確陳述假設(shè)再呈現(xiàn)多種解釋最后才是停下來(lái)問(wèn)。這是一條兜底條款——只有當(dāng)歧義真實(shí)存在、且錯(cuò)誤猜測(cè)的代價(jià)大于澄清成本時(shí)才觸發(fā)。但很多人在本地化時(shí)會(huì)把最后一句刪掉前置條件直接改寫(xiě)成所有任務(wù)開(kāi)始前先列出問(wèn)題清單甚至寫(xiě)進(jìn)系統(tǒng)提示詞強(qiáng)制每次開(kāi)工先提問(wèn)。后果是可以量化的倉(cāng)庫(kù)在第四條原則里自己寫(xiě)了判斷標(biāo)準(zhǔn)——Strong success criteria let you loop independently. Weak criteria (make it work) require constant clarification.強(qiáng)成功標(biāo)準(zhǔn)讓模型獨(dú)立循環(huán)弱標(biāo)準(zhǔn)則需要不斷澄清。當(dāng)澄清變成默認(rèn)協(xié)議每一次任務(wù)都被迫先消耗一輪往返原本一分鐘能完成的瑣碎改動(dòng)被拖成多輪對(duì)話(huà)吞吐量直接腰斬。這也正是 SKILL.md 里那句For trivial tasks, use judgment想防的事。正確的本地化姿勢(shì)保留先陳述假設(shè)和呈現(xiàn)權(quán)衡這兩個(gè)低成本的主動(dòng)行為把提問(wèn)嚴(yán)格限定在假設(shè)被證偽會(huì)破壞正確性的場(chǎng)景同時(shí)為項(xiàng)目維護(hù)一份已知約定清單命名規(guī)范、分層約定、異常策略讓模型先查約定、再判斷是否需要問(wèn)。錯(cuò)誤二拿簡(jiǎn)潔優(yōu)先當(dāng)推倒重寫(xiě)的許可證第二條原則Simplicity First里有一句極具煽動(dòng)性的條文If you write 200 lines and it could be 50, rewrite it.這句話(huà)在原語(yǔ)境里約束的是模型自己剛寫(xiě)出的新代碼——寫(xiě)的時(shí)候發(fā)現(xiàn)膨脹了就重寫(xiě)。但本地化改造時(shí)最常見(jiàn)的誤讀是把它當(dāng)成對(duì)存量代碼的審判標(biāo)準(zhǔn)——這段舊代碼 200 行明顯能精簡(jiǎn)到 50 行重寫(xiě)它。這就和第三條原則Surgical Changes直接打架了。后者寫(xiě)得很死- Dont refactor things that arent broken. - Match existing style, even if youd do it differently. - If you notice unrelated dead code, mention it - dont delete it.不要重構(gòu)沒(méi)壞的東西即使你更喜歡別的寫(xiě)法也要匹配現(xiàn)有風(fēng)格——EXAMPLES.md 里那張反模式對(duì)照表把這個(gè)沖突講得更直白LLM 最常見(jiàn)的錯(cuò)誤恰恰是為了修一個(gè) bug 順手改進(jìn)了相鄰代碼、加了沒(méi)人要的用戶(hù)名校驗(yàn)、改了注釋和 docstring。一個(gè)把200 行改 50 行奉為圭臬的規(guī)則文件等于給這種順帶重構(gòu)發(fā)了許可證。后果在 diff 審查時(shí)爆發(fā)無(wú)關(guān)改動(dòng)淹沒(méi)真正的修復(fù)reviewer 無(wú)法快速定位變更意圖PR 體量膨脹甚至引入回歸。Karpathy 自己在訪(fǎng)談里也承認(rèn)他想讓 LLM 幫他進(jìn)一步精簡(jiǎn) nanoGPT 的代碼模型的表現(xiàn)非常糟糕——簡(jiǎn)化是最難被自動(dòng)化引導(dǎo)的工程行為之一它依賴(lài)對(duì)業(yè)務(wù)語(yǔ)義的完整理解而這恰恰是實(shí)習(xí)生最欠缺的。正確的本地化姿勢(shì)把重寫(xiě)條款的適用范圍限定為本次任務(wù)新產(chǎn)生的代碼并補(bǔ)一條硬規(guī)則——任何對(duì)存量代碼的結(jié)構(gòu)性精簡(jiǎn)必須先單獨(dú)提出并等待確認(rèn)不得與功能改動(dòng)混在同一個(gè)提交里。錯(cuò)誤三抽掉驗(yàn)證回路只留目標(biāo)口號(hào)四條原則里Goal-Driven Execution是唯一自帶閉環(huán)機(jī)制的把指令式任務(wù)轉(zhuǎn)化為可驗(yàn)證目標(biāo)例如Add validation → Write tests for invalid inputs, then make them pass Fix the bug → Write a test that reproduces it, then make it pass并且為多步任務(wù)規(guī)定了顯式的驗(yàn)證格式1. [Step] → verify: [check] 2. [Step] → verify: [check] 3. [Step] → verify: [check]這套機(jī)制的成立前提是你的倉(cāng)庫(kù)存在可執(zhí)行的驗(yàn)證手段。它默認(rèn)你有測(cè)試框架、能寫(xiě)一個(gè)復(fù)現(xiàn) bug 的測(cè)試然后讓它通過(guò)。但大量存量項(xiàng)目根本沒(méi)有測(cè)試基建——老代碼、腳本庫(kù)、一次性任務(wù)倉(cāng)庫(kù)連pytest都沒(méi)有。在這種倉(cāng)庫(kù)里照抄這條規(guī)則得到的結(jié)果是模型每次都輸出verify: test passes這樣的空殼檢查項(xiàng)驗(yàn)證回路變成裝飾性文本規(guī)則名存實(shí)亡。更隱蔽的后果是偽可驗(yàn)證沒(méi)有測(cè)試兜底時(shí)模型會(huì)把構(gòu)建成功或編譯通過(guò)誤當(dāng)成業(yè)務(wù)正確的證據(jù)Karpathy 訪(fǎng)談里談的可驗(yàn)證性概念正是關(guān)鍵——模型能力呈鋸齒狀只有在結(jié)果可驗(yàn)證的領(lǐng)域它才可靠。本地化時(shí)如果不為每條規(guī)則掛上項(xiàng)目里真實(shí)存在的驗(yàn)證鉤子就等于把規(guī)則建立在了模型最不可靠的地基上。正確的本地化姿勢(shì)為每條成功標(biāo)準(zhǔn)指定本項(xiàng)目實(shí)際可用的驗(yàn)證手段——有測(cè)試就用測(cè)試沒(méi)有測(cè)試就退化為明確的可觀(guān)察斷言如手動(dòng)跑通某條命令、檢查特定輸出、對(duì)照 checklist 逐項(xiàng)勾選如果連斷言都做不了這條任務(wù)就不該被交給 Agent 獨(dú)立循環(huán)。錯(cuò)誤四整包粘貼三份規(guī)則互相打架這個(gè)倉(cāng)庫(kù)最大的坑藏在安裝方式里。README 提供了三種入口Claude Code 插件市場(chǎng)/plugin install andrej-karpathy-skillskarpathy-skills、按項(xiàng)目的curl -o CLAUDE.md、以及 Cursor 的.cursor/rules/項(xiàng)目規(guī)則。很多人的本地化改造就是把這三種方式各來(lái)一遍項(xiàng)目里同時(shí)出現(xiàn)了一份插件注入的SKILL.md、一份追加的CLAUDE.md、一份.mdc規(guī)則——三份內(nèi)容一致但生效優(yōu)先級(jí)和讀取機(jī)制完全不同。CURSOR.md 里其實(shí)寫(xiě)了一句關(guān)鍵提示Cursor 默認(rèn)不讀.claude-plugin/和CLAUDE.md反之 Claude Code 也不讀.cursor/rules/。如果你在 Cursor 項(xiàng)目里只粘貼了CLAUDE.md整個(gè)規(guī)則對(duì) Cursor 就是透明的——你以為裝上了其實(shí)一條都沒(méi)生效。反過(guò)來(lái)三份都放但內(nèi)容各自改了一版模型在不同工具里拿到的行為準(zhǔn)則不一致輸出風(fēng)格來(lái)回漂移比不裝更糟。更深一層的沖突來(lái)自合并這一步被跳過(guò)。README 的 Customization 章節(jié)給出了標(biāo)準(zhǔn)姿勢(shì)——在現(xiàn)有CLAUDE.md里追加項(xiàng)目特定指南小節(jié)例如使用 TypeScript 嚴(yán)格模式所有 API 端點(diǎn)必須有測(cè)試遵循src/utils/errors.ts的錯(cuò)誤處理模式。原版規(guī)則的設(shè)計(jì)意圖是作為通用層與項(xiàng)目層疊加而不是整文件覆蓋。直接整包粘貼會(huì)帶來(lái)一類(lèi)典型事故項(xiàng)目約定匹配現(xiàn)有風(fēng)格規(guī)則卻要求如果 200 行能寫(xiě)成 50 行就重寫(xiě)——兩條指令同時(shí)存在時(shí)模型只能隨機(jī)選一條執(zhí)行。正確的本地化姿勢(shì)確立一份源文件 按工具生成三份副本的維護(hù)模型倉(cāng)庫(kù)作者在 CURSOR.md 里就是這么要求貢獻(xiàn)者的項(xiàng)目層約定以追加小節(jié)的方式注入并給規(guī)則標(biāo)注優(yōu)先級(jí)——項(xiàng)目特定指南優(yōu)先于通用指南沖突時(shí)以項(xiàng)目特定指南為準(zhǔn)。三、一份本地化改造檢查清單結(jié)合上面的四個(gè)錯(cuò)誤本地化一份 Karpathy 風(fēng)格技能包時(shí)建議逐項(xiàng)對(duì)照保留權(quán)衡聲明并為本倉(cāng)庫(kù)重寫(xiě)它明確寫(xiě)下本倉(cāng)庫(kù)哪些場(chǎng)景要求謹(jǐn)慎、哪些場(chǎng)景允許快速放行不要沿用原文的通用取向。給提問(wèn)加觸發(fā)條件澄清只發(fā)生在假設(shè)被證偽代價(jià)高的場(chǎng)景為項(xiàng)目維護(hù)約定清單讓模型先查后問(wèn)。重寫(xiě)簡(jiǎn)潔優(yōu)先的作用域明確200 行改 50 行只適用于本次任務(wù)新產(chǎn)生的代碼存量重構(gòu)必須單獨(dú)提 PR。為每條成功標(biāo)準(zhǔn)掛上真實(shí)的驗(yàn)證鉤子測(cè)試、命令、斷言、人工 checklist至少占一樣沒(méi)有驗(yàn)證手段的任務(wù)不承諾獨(dú)立循環(huán)。統(tǒng)一維護(hù)入口規(guī)則正文只維護(hù)一份源文件建議 skills/karpathy-guidelines/SKILL.mdCLAUDE.md、.mdc、插件配置均由此生成杜絕三份漂移。聲明沖突仲裁規(guī)則項(xiàng)目特定指南與通用規(guī)則沖突時(shí)項(xiàng)目特定指南優(yōu)先并把這個(gè)仲裁條款寫(xiě)進(jìn)文件頭部。對(duì)照生效信號(hào)驗(yàn)收倉(cāng)庫(kù)在 How to Know Its Working 里給了四組可觀(guān)察信號(hào)——diff 里無(wú)關(guān)改動(dòng)變少、因過(guò)度復(fù)雜導(dǎo)致的重寫(xiě)變少、澄清問(wèn)題發(fā)生在實(shí)現(xiàn)之前、PR 干凈且無(wú)順帶重構(gòu)。改造后應(yīng)能以這四項(xiàng)做回歸驗(yàn)收。四、判斷本地化成敗的最終標(biāo)準(zhǔn)README.md 最后一段其實(shí)已經(jīng)給出了檢驗(yàn)本地化的終極標(biāo)尺這些規(guī)則起作用的標(biāo)志不是模型記住了多少條文而是代價(jià)發(fā)生的時(shí)機(jī)是否前移——澄清發(fā)生在實(shí)現(xiàn)之前而不是犯錯(cuò)之后diff 里只出現(xiàn)被請(qǐng)求的改動(dòng)重寫(xiě)不是因?yàn)檫^(guò)度復(fù)雜而是因?yàn)樾枨笞兓Q句話(huà)說(shuō)Karpathy 的規(guī)矩本質(zhì)上是把人管理實(shí)習(xí)生的方式顯式化給出成功標(biāo)準(zhǔn)、明確作用邊界、要求及時(shí)匯報(bào)困惑。本地化改造做得對(duì)不對(duì)不看它被抄得多完整而看它是否在你的倉(cāng)庫(kù)里真的改變了那些代價(jià)的分布。照抄只會(huì)得到一個(gè)行為乖張的實(shí)習(xí)生改對(duì)了你才擁有一個(gè)知道什么時(shí)候該問(wèn)、什么時(shí)候該動(dòng)手的穩(wěn)定協(xié)作者。畢竟就像 Karpathy 在訪(fǎng)談里反復(fù)引用的那句話(huà)你可以外包你的思考但你無(wú)法外包你的理解。規(guī)則文件可以外包給模型執(zhí)行但為你的代碼庫(kù)裁剪規(guī)則這件事理解必須留在你這邊?！久赓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），僅供參考