今天這篇文章,來分享一下我自己最近幾個(gè)月高強(qiáng)度使用Agent之后,我自己總結(jié)出來的怎么給Agent設(shè)定規(guī)則,如何讓它Agent更好的工作更聰明的一個(gè)非常重要的心得。
就四個(gè)字。
約束先行。
就是在你讓Agent干任何事情之前,先把規(guī)范定好,全局的規(guī)矩,項(xiàng)目的規(guī)矩,文件夾的規(guī)矩。
規(guī)矩從上往下穿透,一層套一層,沒有規(guī)矩的地方,不動(dòng)手。
就這么簡單的一個(gè)道理,我真的用了好幾個(gè)月才真正想明白,然后完整的落地,你可以說我很菜,花了這么久的時(shí)間,但是我覺得,我踩過了坑,我還是想把這個(gè)經(jīng)驗(yàn)分享出來。
我為什么覺得這四個(gè)字比一切Prompt技巧都重要?得從昨天我的發(fā)生的一個(gè)很小的小事說起。
事情是這樣的。
我這個(gè)人有一個(gè)毛病,就是完美主義強(qiáng)迫癥。
一個(gè)東西如果不是井井有條的,我就渾身難受。
這可能跟我是處女座,也是交互設(shè)計(jì)師,同時(shí)還是重度模擬經(jīng)營玩家有關(guān)。
《城市天際線》里路網(wǎng)沒規(guī)劃好我能推倒重來三次,《動(dòng)物園之星》里動(dòng)物園分區(qū)不合理我能糾結(jié)一下午,《雙點(diǎn)醫(yī)院》里如果有一個(gè)科室的動(dòng)線設(shè)計(jì)得不順,哪怕醫(yī)院已經(jīng)盈利了,我也會(huì)拆了重來。
我到現(xiàn)在還是記得我打《戴森球計(jì)劃》的時(shí)候那沒日沒夜的規(guī)劃生產(chǎn)線的日子。
我朋友經(jīng)常說,我就是那種,對(duì)秩序有一種近乎偏執(zhí)的追求。
雖然我很喜歡kk寫的那本《失控》,我也贊同混亂中涌現(xiàn)一些智慧,但秩序和規(guī)范,可能就是我種在骨子里的東西。
所以昨天下午,當(dāng)我無意中,發(fā)現(xiàn)我的一個(gè)Claude Code的工作文件夾里面越來越亂的時(shí)候,我是真的坐不住了。
我前幾天新建了一個(gè)給Claude Code用的專門用來開發(fā)Skills的文件夾,結(jié)果我昨天打開一看,根目錄散了十幾個(gè)東西。打包文件跟源碼混在一起,測試圖片隨便丟,評(píng)估報(bào)告的HTML文件找不到歸屬。
最離譜的是命名,test_batch是哪個(gè)Skill的測試?test_v2又是誰的v2?我自己做的東西,放了兩天我自己都看不出來。
![]()
我當(dāng)時(shí)就有點(diǎn)應(yīng)激了,真的,一時(shí)間無語凝噎,只能含淚打開Claude Code讓它去給我規(guī)整了,然后直接給我定一個(gè)規(guī)范。
沒過一會(huì),他弄完了。
![]()
然后寫了一個(gè)這個(gè)項(xiàng)目級(jí)別的CLAUDE.md文檔,你可以把這個(gè)文檔,理解為這就是Claude Code進(jìn)入到這個(gè)文件夾以后,第一個(gè)必須要讀且要遵守的東西,就是它以后的行為準(zhǔn)則。
![]()
規(guī)范還是挺全面的。
![]()
有了這個(gè)CLAUDE.md文件以后,我的這個(gè)工作區(qū),就可以不斷的進(jìn)行各種各樣的Skills開發(fā)和實(shí)驗(yàn)了,每個(gè)新的Skills,都會(huì)自動(dòng)給我新建一個(gè)文件夾,一些實(shí)驗(yàn)性的東西會(huì)放在_sandbox里,里面的東西超過一個(gè)月就會(huì)刪除。
再也不會(huì)再混亂的要死,而是按照文件目錄,管理的僅僅有條。
就這個(gè)非常非常小的事情,讓我好好反思了一下。
就是,為什么我的Claude Code進(jìn)到一個(gè)新文件夾、或者開一個(gè)新項(xiàng)目的時(shí)候,自己不會(huì)給自己定這個(gè)規(guī)范呢?一定要我給他定呢?一定要亂七八糟以后我發(fā)現(xiàn)了才能去知道收拾那個(gè)爛攤子呢?
原因也特別簡單,我給Claude Code的頂層約束沒有做好。
也就是在最最頂層,無論是打開什么文件都會(huì)加載的全局CLAUDE.md文檔里面,我并沒有定好這一層約束。
![]()
我自己腦子里過去在開發(fā)各種各樣的項(xiàng)目的時(shí)候一直都有這個(gè)意識(shí),一般我都會(huì)在每個(gè)項(xiàng)目里,讓它先強(qiáng)制寫好文檔再進(jìn)行開發(fā)。
但是還有很多是知識(shí)管理類的工作,不是開發(fā),比如畫圖、比如創(chuàng)造skills、比如做研究報(bào)告等等,而這些工作,并沒有開發(fā)類型的管理意識(shí),所以一般都不會(huì)留下規(guī)范文檔,而我自己也沒發(fā)現(xiàn)。
而對(duì)于AI來說,你腦子里知道的東西,如果沒有寫進(jìn)文檔,就是不存在的。
Agent的短期記憶會(huì)丟失,對(duì)話框一關(guān)全忘了,下次打開,它唯一能看到的就是你留下來的文檔和記憶文件。
你的文檔里寫了什么,是不是足夠清晰,直接決定了Agent每一次醒來的時(shí)候,是清醒的還是懵的。
OpenClaw很多時(shí)候越用越蠢,其實(shí)就是他的規(guī)范和記憶體系真的就是純種屎山,這點(diǎn)Hermes agent比它要做的好的多。
所以這也就是我今天想聊的核心,用好Agent的真正核心,其實(shí)我真的覺得,就是這一整套約束從上往下穿透的體系。
這里解釋一下Claude Code的規(guī)則體系,其實(shí)包括Codex之類的很多Agent都是這樣。
是一層一層疊下來的。
![]()
最頂層,是全局CLAUDE.md。放在用戶目錄下面,無論你打開什么項(xiàng)目都會(huì)加載。這是最高指令和原則,你是誰、你做事的原則、你希望AI用什么方式跟你協(xié)作。
第二層,是項(xiàng)目級(jí)CLAUDE.md。進(jìn)入到某個(gè)項(xiàng)目文件夾才加載。這是這個(gè)項(xiàng)目的憲法,目錄結(jié)構(gòu)怎么組織、命名規(guī)范是什么、什么文件放哪里。
第三層,是項(xiàng)目里的各種規(guī)范文檔、設(shè)計(jì)文檔、架構(gòu)說明。
最底層,是記憶文件。比如Auto Memory啥的,還有對(duì)話記錄,Claude自己給自己做的筆記。
約束從上往下穿透,一層管一層,一層約束一層。
跟治理公司是一樣的,制度在最上面,部門規(guī)范在中間,具體操作流程在最下面,你不可能靠CEO每天挨個(gè)盯著員工干活,你靠的是制度穿透下去。
這就是「約束先行」的完整含義。
而如何設(shè)計(jì)這套體系,特別是頂層的制度規(guī)范,真的不是一個(gè)簡單活,開過公司的人相信都能明白我在說啥,那真的是血和淚的教訓(xùn)。
而全局CLAUDE.md,對(duì)應(yīng)的就是這個(gè)最高制度。
我的全局CLAUDE.md,其實(shí)已經(jīng)迭代了好多個(gè)版本了。
去年最早的時(shí)候我也不懂,抄了很多開發(fā)大神的所謂的開發(fā)規(guī)則,然后又不斷地往里面迭代經(jīng)驗(yàn),搞得后面特別臃腫。后來慢慢意識(shí)到適合自己的才是最好的,以及很多經(jīng)驗(yàn)就不該在這一層,又開始一輪一輪地瘦身。
在今天補(bǔ)了規(guī)則之后,現(xiàn)在我的全局CLAUDE.md文檔長這樣,這里我也完整的給大家展示出來。
- 部署走項(xiàng)目自己的命令(查項(xiàng)目 CLAUDE.md),不依賴 git push你會(huì)發(fā)現(xiàn),這里面的每一條,其實(shí)現(xiàn)在我覺得最好的基于某種形式的約束。
比如第一性原理,是對(duì)思考方式的約束,不要因?yàn)閼T例就照搬,要回到問題本身。
比如反諂媚,是對(duì)溝通方式的約束,不要拍馬屁,給真實(shí)判斷。
比如,交互設(shè)計(jì)原則。我是用戶體驗(yàn)出身,所以我對(duì)從我手上出去的東西有一個(gè)執(zhí)念,后端可以很復(fù)雜,但用戶碰到的每一層必須絲滑。這不只是GUI的事,CLI也是交互,Skill也是交互,對(duì)話式AI也是交互。
現(xiàn)在這個(gè)年代,大家都在vibe coding,但我發(fā)現(xiàn)越來越多的人開始不重視用戶體驗(yàn)了,很多產(chǎn)品都是能跑起來就行,管你用著爽不爽。
這個(gè)我是真的覺得不行。
所以我在全局規(guī)范里寫了五條我總結(jié)的交互設(shè)計(jì)核心原則。寫進(jìn)去之后Claude做出來的東西確實(shí)不一樣了。
![]()
而約束先行這條,它就兩段話,但它解決的也是一個(gè)根問題。
已有規(guī)范的項(xiàng)目,嚴(yán)格遵守其 CLAUDE.md 中的約定。需要調(diào)整規(guī)范時(shí)先改文檔、再改實(shí)踐,不要反過來。以前Agent進(jìn)到一個(gè)新項(xiàng)目,因?yàn)樘匦裕缘谝环磻?yīng)總是立刻開始干活。
現(xiàn)在,你定好了約束之后,它的第一反應(yīng)是先看看有沒有規(guī)范,沒有的話先建規(guī)范。
后面那句需要調(diào)整規(guī)范時(shí)先改文檔、再改實(shí)踐不要反過來也很重要。
規(guī)則不是死的,但改規(guī)則也要走規(guī)則的路。
不然Agent為了趕進(jìn)度繞過約定,事后你想補(bǔ)文檔真的都不知道從哪補(bǔ)起。
寫到這,我真的忽然覺得,引導(dǎo)Agent,真的,跟我現(xiàn)在管理公司的時(shí)候,真的好像沒什么兩樣。
公司你也要部門、要制度、要SOP、要協(xié)同,要規(guī)矩,要一切,不一個(gè)樣嗎。
而且不只是開公司,很多真正玩模擬經(jīng)營的人都知道一個(gè)道理。
游戲前期最重要的不是趕緊建建建,而是先把路網(wǎng)規(guī)劃好。
路網(wǎng)一旦規(guī)劃歪了,后面再怎么優(yōu)化你都沒招,只能一切全部鏟了重來,我經(jīng)歷過無數(shù)血和淚的教訓(xùn)。
你的CLAUDE.md就是你的路網(wǎng)。
全局CLAUDE.md是城市主干道,項(xiàng)目CLAUDE.md是片區(qū)支路,主干道規(guī)劃好了,支路自然就順了。
你花一個(gè)小時(shí)把它寫好,你相信我,后面能省無數(shù)個(gè)小時(shí)的返工。
今天分享的這些東西,你要說這算Harness Engineering,那也行,因?yàn)镠arness本身就是約束。
你要說這不算,就是一些基本的項(xiàng)目管理常識(shí),那也沒錯(cuò)。
反正我覺得,名字不重要,最重要的,就是你有沒有找到一套讓自己跟Agent協(xié)作起來舒服的方式。
我有時(shí)候覺得吧,我這輩子做的事情其實(shí)都是同一件事。
做交互設(shè)計(jì)的時(shí)候,是在給用戶行為建約束。
玩模擬經(jīng)營的時(shí)候,是在給虛擬城市建約束。
開公司了,是在給業(yè)務(wù)和人建約束。
現(xiàn)在跟Agent協(xié)作,還是在建約束。
對(duì)象變了,方法卻是一樣的。
先想清楚你要什么,定好規(guī)則,然后在規(guī)則框架里做出最優(yōu)解。
這就是最棒的方法。
以上,既然看到這里了,如果覺得不錯(cuò),隨手點(diǎn)個(gè)贊、在看、轉(zhuǎn)發(fā)三連吧,如果想第一時(shí)間收到推送,也可以給我個(gè)星標(biāo)?~謝謝你看我的文章,我們,下次再見。
>/ 作者:卡茲克
>/ 投稿或爆料,請(qǐng)聯(lián)系郵箱:wzglyay@virxact.com
特別聲明:以上內(nèi)容(如有圖片或視頻亦包括在內(nèi))為自媒體平臺(tái)“網(wǎng)易號(hào)”用戶上傳并發(fā)布,本平臺(tái)僅提供信息存儲(chǔ)服務(wù)。
Notice: The content above (including the pictures and videos if any) is uploaded and posted by a user of NetEase Hao, which is a social media platform and only provides information storage services.