新智元報(bào)道

編輯：元宇

【新智元導(dǎo)讀】當(dāng)普通人還在鉆研「最強(qiáng)提示詞咒語(yǔ)」時(shí)，硅谷頂級(jí)實(shí)驗(yàn)室已經(jīng)把AI基建跑成了生產(chǎn)線。

你還在ChatGPT的聊天框里反復(fù)調(diào)prompt？

最近，一位X用戶(hù)發(fā)了條推文，開(kāi)頭就是一個(gè)驚呼：頭部大廠偷偷在用的Claude Code項(xiàng)目模板外泄！

這已經(jīng)不是寫(xiě)提示詞了。這是AI工程基礎(chǔ)設(shè)施。

整套打法圍繞一個(gè)文件「CLAUDE.md」展開(kāi)，而它的核心原則只有三條：

每次Claude犯錯(cuò)→你加一條規(guī)則；每次你重復(fù)自己→你加一個(gè)工作流；每次出bug→你加一道護(hù)欄。

這樣做，是要把項(xiàng)目經(jīng)驗(yàn)沉淀成它每次啟動(dòng)都會(huì)讀取的長(zhǎng)期上下文和自動(dòng)化約束。

整個(gè)架構(gòu)，像是一家AI公司的崗位編制：CLAUDE.md是入職手冊(cè)，skills/是工作SOP，hooks/是合規(guī)部，docs/是公司章程，tools/是后勤組，src/才是真正出活的業(yè)務(wù)部門(mén)。

你不再是在和AI聊天了，而是在構(gòu)建一個(gè)了解你代碼倉(cāng)庫(kù)的AI。

最瘋狂的部分是，你只需要配置一次，Claude就會(huì)自動(dòng)審查代碼，并按指令重構(gòu)、強(qiáng)制執(zhí)行架構(gòu)規(guī)則、撰寫(xiě)發(fā)布說(shuō)明、從技能中運(yùn)行工作流、記住過(guò)去錯(cuò)誤等。

而且它會(huì)越用越聰明。

大多數(shù)人，都是打開(kāi)ChatGPT，寫(xiě)提示詞，復(fù)制粘貼，反復(fù)；而在這套打法下，你只需要打開(kāi)終端，跑一個(gè)skill代碼已交付。

這等于是在自己的代碼庫(kù)里養(yǎng)了一隊(duì)AI同事。

這條推文背后，傳遞的是這個(gè)時(shí)代正在悄悄翻篇的一個(gè)小信號(hào)，大多數(shù)人可能還沒(méi)反應(yīng)過(guò)來(lái)。

一張不算泄露的「泄露截圖」

撕開(kāi)一個(gè)真相

@ai_rohitt曬出來(lái)的這張截圖，是Anthropic官方文檔里公開(kāi)推薦的Claude Code標(biāo)準(zhǔn)范式。

CLAUDE.md是Claude Code在每次會(huì)話開(kāi)始時(shí)自動(dòng)讀取的項(xiàng)目記憶文件。

.claude/skills/和.claude/hooks/是官方支持的擴(kuò)展機(jī)制。

這些都是社區(qū)已經(jīng)討論了幾個(gè)月的公開(kāi)做法，并不是什么人偷出來(lái)的「內(nèi)部模板」。

但它之所以能讓一些資深開(kāi)發(fā)者主動(dòng)轉(zhuǎn)發(fā)，說(shuō)明它得到了一些天天用Claude的開(kāi)發(fā)者們的認(rèn)同。

其中相當(dāng)一部分人，可能這兩天才意識(shí)到原來(lái)它還能這么用。

而硅谷頂級(jí)團(tuán)隊(duì)，已經(jīng)把這件事跑成了生產(chǎn)線。

第一個(gè)例子，是OpenAI Frontier團(tuán)隊(duì)。

OpenAI官方披露的Frontier團(tuán)隊(duì)實(shí)驗(yàn)中，一個(gè)從空repo起步的內(nèi)部beta，在約5個(gè)月內(nèi)由Codex生成了約100萬(wàn)行代碼和約1500個(gè)PR；團(tuán)隊(duì)從3人擴(kuò)展到7人，人工不直接寫(xiě)代碼。

帶隊(duì)的Ryan Lopopolo在后續(xù)訪談中進(jìn)一步提到，這套工作流已經(jīng)接近「0 人工代碼、0 人工 review」的極限形態(tài)。

他認(rèn)為與其節(jié)省token，不如利用模型極高的并發(fā)能力和極低的成本來(lái)代替人類(lèi)有限且昂貴的同步注意力。

第二個(gè)例子，是Stripe內(nèi)部的自動(dòng)化代碼代理系統(tǒng)Minions。

Stripe內(nèi)部的Minions每周生成并推動(dòng)超過(guò)1300個(gè)PR合并，這些代碼從頭到尾由AI生成，但仍經(jīng)過(guò)人工review。

這里還有一對(duì)數(shù)據(jù)：1.6%vs98.4%，它來(lái)自Mohamed bin Zayed AI大學(xué)VILA-Lab發(fā)表的一篇論文。

https://arxiv.org/pdf/2604.14228

研究者系統(tǒng)性扒了Claude Code v2.1.88版本51.2萬(wàn)行TypeScript源碼，給出的結(jié)論是：只有1.6%是AI決策邏輯，剩下的98.4%是確定性的工程基礎(chǔ)設(shè)施。

具體說(shuō)就是權(quán)限網(wǎng)關(guān)、上下文管理、工具路由、錯(cuò)誤恢復(fù)這四類(lèi)。

這組數(shù)字不是說(shuō)模型只貢獻(xiàn)1.6%的能力，而是說(shuō)明Claude Code作為產(chǎn)品，大量復(fù)雜度不在模型本身，而在權(quán)限、上下文、工具路由、恢復(fù)機(jī)制等確定性工程基礎(chǔ)設(shè)施上。

@ai_rohitt那張圖里的CLAUDE.md/skills/hooks結(jié)構(gòu)，就是普通開(kāi)發(fā)者也能搭一套的「入門(mén)版基建」，它和OpenAI、Stripe那套生產(chǎn)級(jí)架構(gòu)是同一種范式，只是規(guī)模小得多。

CLAUDE.md暴露的秘密

過(guò)去3年，所有人都在問(wèn)「GPT什么時(shí)候能更聰明」「Claude什么時(shí)候出新版本」。

但真正在生產(chǎn)環(huán)境跑通AI編程的團(tuán)隊(duì)，他們更關(guān)心的可能根本不是這個(gè)，而是如何讓AI記住自己上次踩過(guò)的坑，怎么讓AI在動(dòng)手前先看一眼項(xiàng)目的架構(gòu)約束，怎么讓AI犯錯(cuò)的時(shí)候自己被工具擋住。

CLAUDE.md正是這一切的承載體。

Anthropic官方對(duì)它的定義只有一句：

一個(gè)markdown文件，放在項(xiàng)目根目錄，Claude Code在每次會(huì)話開(kāi)始時(shí)自動(dòng)讀取。

https://code.claude.com/docs/en/memory

聽(tīng)上去很簡(jiǎn)單，圍繞它展開(kāi)的那幾層結(jié)構(gòu)，才是它真正厲害的部分。

CLAUDE.md是項(xiàng)目大腦。

架構(gòu)決策、命名約定、測(cè)試要求、那些反復(fù)踩過(guò)的坑，都堆在這里。它是AI每次啟動(dòng)時(shí)第一眼看到的「員工手冊(cè)」。

.claude/skills/是可復(fù)用工作流。

Claude Code的創(chuàng)建者Boris Cherny在社區(qū)里反復(fù)強(qiáng)調(diào)一句話：「如果你每天做某件事超過(guò)一次，把它變成skill或command?！?/p>

一個(gè)skill就是一段可執(zhí)行的方法論。Code review、生成commit message、寫(xiě)發(fā)布說(shuō)明，這些都不該是每天手敲提示詞的活，應(yīng)該是skill調(diào)一下就出結(jié)果。

.claude/hooks/是自動(dòng)護(hù)欄。

這是最關(guān)鍵的部分。它不依賴(lài)AI自己判斷，由確定性代碼在AI犯錯(cuò)之前就擋住它。這就是為什么敢讓AI「無(wú)人監(jiān)督」地跑，因?yàn)槌鲥e(cuò)的邊界由hooks卡死了。

docs/decisions/是架構(gòu)決策記錄。

讓AI不僅知道代碼「是什么」，還知道代碼「為什么是這樣」。

這一項(xiàng)最容易被忽略，但也是AI協(xié)作最大的杠桿點(diǎn)。

tools/和src/是執(zhí)行層。

這套架構(gòu)真正值得注意的地方，不在于某個(gè)開(kāi)發(fā)者搞出了一個(gè)漂亮目錄，而是越來(lái)越多獨(dú)立團(tuán)隊(duì)正在收斂到同一個(gè)方向：把模型放進(jìn)一套由上下文、工具、權(quán)限、評(píng)估和反饋循環(huán)組成的harness里。

GitHub上已經(jīng)能看到不少類(lèi)似項(xiàng)目：

rohitg00的awesome-claude-code-toolkit、diet103的claude-code-infrastructure-showcase、affaan-m的everything-claude-code，都在圍繞agents、skills、hooks、rules、MCP configs等組件搭建Claude Code的工程化工作環(huán)境。

這說(shuō)明，真正成熟的AI編程工作流，不是只靠一個(gè)更強(qiáng)的模型，也不是只靠一條更長(zhǎng)的prompt，而是把模型嵌入一套可復(fù)用、可約束、可恢復(fù)、可審計(jì)的工程系統(tǒng)里。

至于具體目錄結(jié)構(gòu)，各家實(shí)現(xiàn)并不完全相同。

OpenAI實(shí)驗(yàn)室的極限實(shí)驗(yàn)

2026年2月11日，OpenAI官方博客發(fā)了一篇文章：《Harness engineering: leveraging Codex in an agent-first world》。

https://openai.com/index/harness-engineering/

Anthropic圍繞這個(gè)概念重新調(diào)整了Claude Code的架構(gòu)思路；Martin Fowler的網(wǎng)站把它凝練成一個(gè)公式：「Agent=Model+Harness?！?/p>

Harness這個(gè)詞來(lái)自馬術(shù)。它指的是馬的整套挽具，韁繩、馬嚼子、馬鞍、籠頭。

一匹馬可以跑得很快很有力，但它自己不知道往哪兒走：整套挽具決定了它的方向。

類(lèi)比到AI編程：模型本身能力很強(qiáng)，但它不知道在你的代碼庫(kù)里該往哪兒走。Harness就是你為它造的方向盤(pán)+剎車(chē)+導(dǎo)航。

OpenAI Frontier團(tuán)隊(duì)那個(gè)「100萬(wàn)行0人工」的實(shí)驗(yàn)，本質(zhì)就是把Harness做到極致。

他們的關(guān)鍵工程實(shí)踐包括以下幾條。

層級(jí)架構(gòu)強(qiáng)約束。

從Types到Config到Repo到Service到Runtime到UI，依賴(lài)關(guān)系單向流動(dòng)，由linter在CI層強(qiáng)制執(zhí)行。Agent寫(xiě)出違反層級(jí)關(guān)系的代碼？直接構(gòu)建失敗。

linter錯(cuò)誤信息本身是修復(fù)指令，這也是最反直覺(jué)的細(xì)節(jié)。

普通項(xiàng)目的lint錯(cuò)誤是「violation detected」，給人看的；OpenAI Frontier的lint錯(cuò)誤是「use logger.info({event: 'name', ...data}) instead of console.log」，給Agent看的、可以直接讀懂并修復(fù)的指令。

文檔作為單一事實(shí)來(lái)源。所有架構(gòu)圖、execution plans、設(shè)計(jì)規(guī)范都在倉(cāng)庫(kù)內(nèi)部的docs/目錄。Agent不需要任何外部知識(shí)庫(kù)，一切就在repo里。

這套東西效果有多厲害？

模型沒(méi)有換，但LangChain調(diào)整了harness，包括系統(tǒng)提示、工具、中間件和推理模式，最終把Terminal Bench 2.0分?jǐn)?shù)從52.8提到66.5。

你今天就能做的事

是為AI造一個(gè)項(xiàng)目大腦

問(wèn)題回到普通開(kāi)發(fā)者這里：如果范式已經(jīng)轉(zhuǎn)移，作為一個(gè)普通工程師，今天就能做點(diǎn)什么。

第一件事，在你最重要的項(xiàng)目根目錄建一個(gè)CLAUDE.md。

不需要完美，也不需要很長(zhǎng)。寫(xiě)下你團(tuán)隊(duì)的架構(gòu)規(guī)則、命名約定、測(cè)試要求、那些反復(fù)踩過(guò)的坑，10分鐘能寫(xiě)完一個(gè)能用的版本。

下次AI犯錯(cuò)的時(shí)候，先不要手動(dòng)修，而是問(wèn)自己一句：CLAUDE.md里缺了什么？

第二件事，把每天重復(fù)做的事改造成skill。

這里要注意Boris Cherny的金句：「如果你每天做某件事超過(guò)一次，把它變成skill或command?！?/p>

Code review、生成commit message、寫(xiě)發(fā)布說(shuō)明、修一類(lèi)重復(fù)的bug，這些都該是skill，不該是每天手敲提示詞。

第三件事，在容易踩坑的地方加一個(gè)hook。

Hook是98.4%里最有杠桿的那部分。它不依賴(lài)AI變聰明，它依賴(lài)確定性代碼做強(qiáng)制檢查。這是把人類(lèi)工程師的判斷力翻譯成機(jī)器可讀約束的過(guò)程。

這件事的核心不在寫(xiě)代碼，而在寫(xiě)規(guī)則。

Karpathy今年1月在推特上的那句被廣泛轉(zhuǎn)發(fā)的話：「我已經(jīng)從80%手動(dòng)寫(xiě)代碼變成了80%交給Agent寫(xiě)?！?/p>

未來(lái)五年，工程師的能力曲線正在從「我能寫(xiě)多少行代碼」轉(zhuǎn)向「我能為AI設(shè)計(jì)多嚴(yán)格的工作環(huán)境」。

寫(xiě)代碼的活兒正在被Agent接管。

但設(shè)計(jì)那個(gè)讓Agent能寫(xiě)出好代碼的世界，還是人的工作。而且比以前更難、更重要、也更有意思。

參考資料：

https://x.com/ai_rohitt/status/2048390767115428016?s=20

https://arxiv.org/pdf/2604.14228