一個(gè)CLAUDE.md霸榜GitHub第一！蒸餾自Karpathy，6萬(wàn)碼農(nóng)抄作業(yè)

新智元報(bào)道

編輯：好困

【新智元導(dǎo)讀】一個(gè)毫無(wú)代碼的文本，竟連霸GitHub熱榜第一。Karpathy的編程神技被化作「AI緊箍咒」，讓亂寫(xiě)B(tài)ug的大模型瞬間老實(shí)！

就在剛剛，一個(gè).md文件沖爆了整個(gè)GitHub！

本周新增44,465顆星，總星數(shù)61.6k。連續(xù)三天Trending日榜第一。

它叫CLAUDE.md，一個(gè)Markdown配置文件。

里面寫(xiě)著四條規(guī)矩，全部源自Karpathy對(duì)LLM編程陷阱的觀察，用來(lái)管住AI編程時(shí)最常犯的毛病——

• 不確定的先問(wèn)別瞎猜

• 代碼能簡(jiǎn)短就別寫(xiě)長(zhǎng)

• 沒(méi)讓你改的地方別碰

• 給目標(biāo)別給步驟

把它丟進(jìn)項(xiàng)目根目錄，AI編程Agent就會(huì)自動(dòng)讀取并遵守里面的規(guī)則。

項(xiàng)目地址：https://github.com/forrestchang/andrej-karpathy-skills

如今，全網(wǎng)6萬(wàn)碼農(nóng)連夜抄作業(yè)，X上開(kāi)發(fā)者已經(jīng)炸了鍋。

Kraggich感慨道，「一個(gè)Markdown文件沖上趨勢(shì)榜第一，說(shuō)明現(xiàn)在的瓶頸不在模型，而在模型周?chē)哪_手架。這些'膠水'才是產(chǎn)品本身。」

Surajdotdot7從生產(chǎn)環(huán)境算了筆賬，「模型選錯(cuò)了分支，運(yùn)行了40分鐘，最后碰壁失敗。而提前澄清只需要30秒。」

Markdown里寫(xiě)了什么

故事的起點(diǎn)是今年1月26日。Karpathy在X上發(fā)了一條長(zhǎng)帖，詳細(xì)吐槽了AI編程Agent的各種毛病。

當(dāng)天，一個(gè)叫Jiayuan Zhang的華人開(kāi)發(fā)者就動(dòng)了手。

他先是用Claude Code把這條帖子自動(dòng)轉(zhuǎn)化成了skills文件，并生成了約800行描述，然后讓Claude自己審查自己，最后砍成了一段約70行的干凈指令。

產(chǎn)物就是這個(gè)CLAUDE.md，相當(dāng)于是在Agent腦子里裝的一套行為準(zhǔn)則。（現(xiàn)在也有了Cursor版）

里面的四條原則，每一條都精準(zhǔn)對(duì)應(yīng)了開(kāi)發(fā)者用AI寫(xiě)代碼時(shí)最常踩的坑。

原則一，編碼前先思考。

你讓AI「加個(gè)驗(yàn)證功能」，它不會(huì)問(wèn)你要驗(yàn)證什么、嚴(yán)不嚴(yán)格，而是自己猜一個(gè)最復(fù)雜的方案，寫(xiě)了一大堆你根本不需要的代碼。更糟糕的是，整個(gè)過(guò)程它不會(huì)表現(xiàn)出任何猶豫。

為了解決這個(gè)問(wèn)題，文檔在第一個(gè)原則中寫(xiě)了三條規(guī)定：

1. 不確定時(shí)必須停下來(lái)問(wèn)，不能猜。

2. 存在多種理解時(shí)列出選項(xiàng)讓用戶選，而不是替你做決定。

3. 發(fā)現(xiàn)有更簡(jiǎn)單的方案時(shí)，主動(dòng)說(shuō)出來(lái)，該推回來(lái)就推回來(lái)。

原則二，簡(jiǎn)約至上。

你要一個(gè)簡(jiǎn)單的小功能，它給你寫(xiě)出一整套企業(yè)級(jí)架構(gòu)，附帶登錄認(rèn)證、安全校驗(yàn)、流量控制。

你說(shuō)「能簡(jiǎn)單點(diǎn)嗎」，它立刻砍掉大半，還來(lái)一句「當(dāng)然可以！」說(shuō)明它一開(kāi)始就知道不用寫(xiě)那么多，但就是忍不住。

第二條原則，就是給這些問(wèn)題預(yù)備的：

1. 沒(méi)被要求的功能不寫(xiě)。

2. 只用一次的代碼不建抽象層。

3. 沒(méi)人要求的「靈活性」和「可配置」不加。

4. 不可能發(fā)生的異常場(chǎng)景不做錯(cuò)誤處理。

檢驗(yàn)標(biāo)準(zhǔn)就一條，一個(gè)資深工程師看了會(huì)不會(huì)說(shuō)「太復(fù)雜了」。會(huì)的話，直接砍。

原則三，精確編輯。

你讓它修一個(gè)bug，它改完bug順手把旁邊的代碼也重構(gòu)了，變量名換了，注釋刪了，代碼風(fēng)格也按它自己的偏好改了。最后你對(duì)比改動(dòng)記錄，改了30處，其中25處跟你的需求毫無(wú)關(guān)系。

于是，第三條原則給改動(dòng)范圍做了嚴(yán)格的限制：

1. 只動(dòng)你被要求動(dòng)的部分。

2. 匹配項(xiàng)目已有的代碼風(fēng)格，哪怕你覺(jué)得自己寫(xiě)得更好。

3. 看到不相關(guān)的問(wèn)題，提一嘴就行，別動(dòng)手。

4. 如果你的改動(dòng)導(dǎo)致某些代碼不再被使用，清理掉，那是你的責(zé)任。但之前就存在的問(wèn)題，沒(méi)人讓你改就不要碰。

原則四，目標(biāo)驅(qū)動(dòng)。

AI特別擅長(zhǎng)「循環(huán)到達(dá)標(biāo)為止」這件事，那就別告訴它具體步驟，直接給它驗(yàn)收標(biāo)準(zhǔn)讓它自己跑。

比如你要加一個(gè)功能，別說(shuō)「寫(xiě)一個(gè)函數(shù)實(shí)現(xiàn)X」，改成「先寫(xiě)測(cè)試用例，然后讓所有測(cè)試通過(guò)」。要修一個(gè)bug，改成「先寫(xiě)一個(gè)能復(fù)現(xiàn)這個(gè)bug的測(cè)試，然后讓它通過(guò)」。

如果任務(wù)比較復(fù)雜，就要求AI先列出分步計(jì)劃，然后每一步都帶上驗(yàn)證方式。

因?yàn)椋?yàn)收標(biāo)準(zhǔn)定得越清晰，AI能獨(dú)立循環(huán)執(zhí)行的時(shí)間就越長(zhǎng)，你需要介入的頻率就越低。

這是用AI編程時(shí)杠桿最大的一條原則。

誰(shuí)做的？

這個(gè)倉(cāng)庫(kù)的作者叫Jiayuan Zhang，開(kāi)源項(xiàng)目Multica的創(chuàng)始人兼CEO。

他做的Multica，就是把Claude Code、OpenCode、Codex CLI這些AI編程Agent統(tǒng)一管理起來(lái)，像真正的團(tuán)隊(duì)成員一樣分配任務(wù)、匯報(bào)進(jìn)展、交付代碼。就連不會(huì)用命令行的人，也能通過(guò)它用上Claude Code級(jí)別的編程Agent能力。

正如項(xiàng)目介紹所說(shuō)：

Your next 10 hires won't be human.

你接下來(lái)招的10名員工，都不會(huì)是人類了。

他們公司的代碼100%由AI編寫(xiě)，每天消耗的token量超過(guò)1億。

80%的代碼，不用自己寫(xiě)了

回到Karpathy的原帖，他說(shuō)的其實(shí)是一件更大的事。

作為一個(gè)編了20年代碼的人，他說(shuō)短短幾周內(nèi)，自己的編程工作流從「80%手寫(xiě)+20%AI輔助」徹底翻轉(zhuǎn)成了「80%交給Agent+20%自己修補(bǔ)」。

他看著Agent死磕一個(gè)問(wèn)題整整30分鐘，要是人類早放棄了，而它就是不停地試，最后居然過(guò)了。

這種「feel the AGI」的時(shí)刻會(huì)讓你意識(shí)到，工作的核心瓶頸之一「耐力」已經(jīng)徹底被LLM炸開(kāi)了。

但他也看到了硬幣的反面。他預(yù)言了一個(gè)詞，「Slopacolypse」。

2026年GitHub、arXiv、社交媒體上會(huì)涌出大量AI生成的低質(zhì)量?jī)?nèi)容。生產(chǎn)力是真的，質(zhì)量垮塌的風(fēng)險(xiǎn)也是真的。

甚至，他說(shuō)自己已經(jīng)開(kāi)始感覺(jué)到手寫(xiě)代碼的能力在萎縮。

就是那種，你可以看懂代碼但寫(xiě)不出來(lái)的感覺(jué)。

為什么一個(gè).md文件能炸成這樣

在Karpathy看來(lái)，LLM編程帶來(lái)的不只是加速，更是一種擴(kuò)展，你能做到以前不值得做的事，能碰以前碰不了的代碼。

如今，這個(gè)概念升級(jí)為「agentic engineering」，一種把AI當(dāng)做需要明確目標(biāo)、清晰邊界和嚴(yán)格測(cè)試的協(xié)作伙伴來(lái)對(duì)待的工程學(xué)科。

andrej-karpathy-skills這個(gè)倉(cāng)庫(kù)，就是agentic engineering最早的「教材」之一。

它之所以炸了，核心在于它把一個(gè)頂級(jí)工程師的隱性知識(shí)，打包成了Agent可以直接讀取的格式。

說(shuō)到底，Karpathy不再只是一個(gè)你讀的人，而是一個(gè)你的Agent可以直接繼承行為的人。

這才是這個(gè)倉(cāng)庫(kù)真正瘋狂的地方。

參考資料：

https://x.com/Voxyz_ai/status/2045899539526148193?s=20

https://github.com/forrestchang/andrej-karpathy-skills/blob/main/CLAUDE.md