萬事起頭難,在著手為你的專案建立第一份專案憲法時,許多人常會面臨「不知道該寫什麼」的窘境。
幸運的是,Cline 或 Cursor 的開發套件中,內建了一個非常強大的自動化初始化工具:slash init 指令(或在 Codex 中輸入 slashinit)。只要在編輯器對話框中輸入這個指令,AI 就會主動掃描你的整個專案,自動識別專案所採用的技術框架、資料夾目錄結構、以及現有的代碼風格,並在幾秒鐘之內,為你生成一份結構極為完整的 CLAUDE.md 初始範本。
然而,大神的實戰心法給了我們一個震撼的啟示:AI 自動生成的初始檔案通常「整理得太完整了」,如果你直接照單全收,這將會是系統智商退化的起點。
CLAUDE.md 修剪三問
查得到的現狀,不必塞進長期規則。
少數任務才用的規則,移到局部或動態文件。
短期過渡要求,解決後就該移除。
實戰步驟一:執行 slash init 並用「過濾三提問」進行大修剪
要打造一份高first-pass成功率的專案記憶,你必須在初始化後,立刻對檔案進行毫不留情的「減法修剪」:
一鍵生成初始範本:在編輯器中輸入 slash init,讓 AI 快速掃描專案,吐出包含專案現狀、啟動與測試指令的第一版 CLAUDE.md。
套用大神的三個核心提問,進行嚴格過濾:從第一行開始,逐條檢視初始範本中的內容,只要符合以下任一條件,請立刻刪掉它:
提問一:「這件事,AI 自己的 explorer subagent 機制本來就查得到嗎?」 12, 15當你在 Cline/Cursor 下達任務時,AI 並不會盲目動工,它會在背景啟動一個資源探測器(Explorer Subagent)去主動讀取你的 package.json、requirements.txt 或掃描資料夾目錄。既然 AI 本來就自己查得出來「這個專案是用 TypeScript、包含哪些目錄」,就絕對不要寫進 CLAUDE.md 裡浪費寶貴的空間。
提問二:「這條規則,是每次或大部分工作都會用到的嗎?」 15如果這條規則只跟特定的前端測試有關,立刻把它移出全域的 CLAUDE.md,改放到 /frontend 子目錄下的 Nested Level 檔案中。
提問三:「這件事在幾個月之後,還會成立、不變嗎?」 15像是「目前暫時使用舊版 API」或「明天中午前要改完某個 Bug」這種極具時效性的過渡期要求,一旦解決就失效了。如果一直留在 CLAUDE.md 裡,未來只會誤導 AI 繼續用過期、錯誤的方式寫程式。
實戰步驟二:理解 Instruction Budget,防止 AI 的「規則超載」
修剪檔案不只是為了排版好看,背後有著極為嚴肅的軟體工程學理——保護 AI 的指令預算(Instruction Budget):
區分兩大腦容量瓶頸:Context Window(上下文視窗)決定 AI 一次能吞下多少資料量;而 Instruction Budget(指令預算)則決定 AI 在處理這些資料時,大腦能同時顧好多少條規則約束。
封殺規則衝突與注意力稀釋:AI 在讀取每一條指令時,都必須在背後耗費推理算力去盤算:「這條規則現在適用嗎?它跟其他規則有沒有衝突?我這次產出該優先聽哪一條?」。當你塞了太多「AI 自己本來就知道的客觀現狀」時,它的注意力預算就會被雜訊大量佔滿,導致真正重要、絕對不能出錯的致命紅線,在執行時被 AI 忘得一乾二淨。因此,剪掉廢話,才是保護 AI 智商的最佳防線。