CLAUDE.md 分兩層:一份管整個資料夾,一份管單一專案
「我有好幾個專案,每個都有自己的 CLAUDE.md。那些每個專案都要遵守的規矩,要寫在哪?」夥伴的提問
對所有專案都成立的寫上層,只屬於這個專案的寫下層。課堂上用一段話請 AI 建好上層那份:工作範圍、規則的優先順序、專案索引表。它還順便回報了兩個說明書和實際對不上的地方。
一個專案有一份 CLAUDE.md。那第二個、第三個專案呢?每一份都要把同樣的規矩再寫一次嗎?
先看問題
01有些規矩是「我的」,有些是「這個專案的」
CLAUDE.md 是放在資料夾裡、給 AI 的長期說明書。它每次開工都會先讀。
課堂上夥伴的專案資料夾裡已經有一份,寫的是這個作品的設定和協作規則。但還有另一種規矩不屬於任何一個作品:只准在哪裡工作、一律用繁體中文、不准刪檔。這些寫在單一專案裡,下一個專案就得重抄。
上層:管整個工作區
放在最外面那個資料夾。寫對所有專案都成立的規矩,再加一張「底下有哪些專案」的索引。
下層:管單一專案
放在各自的專案資料夾。只寫這個專案自己的事:資料夾地圖、名詞、這個專案的做法。
課堂上的示範
一段話,請 AI 建好上層那一份
嚮導講的那段話
02用說的,講完整
打開 Claude 桌面版的 Code 分頁,選好最外層的資料夾,按麥克風講。下面是整理過的版本,資料夾名稱換成了通用的說法:
我想像的是:「工作區」這個資料夾,才是 Claude 可以使用的,其他的資料夾都不可以使用。請你在這個資料夾下,寫一份專門給整個環境用的 CLAUDE.md,幫我管理這個資料夾下的所有專案資料夾。現在這裡面只有第一個專案資料夾,你應該看得到,而且它有自己的 CLAUDE.md。請問我這樣表達清楚嗎?有疑問請問我,清楚的話請幫我建立,謝謝。
它交回來的東西
03先複述理解,再說建了什麼
它先把聽到的整理成三句:只在這個資料夾裡工作;最上層有一份全域的說明書管所有專案;每個專案另外有自己的一份。然後才說建好的那份裡面有什麼:
工作範圍
只在工作區裡讀寫。需要外面的檔案要先問你。不刪除任何檔案。
規則的優先順序
你當下直接講的話最優先,其次是專案的說明書,最後才是全域規則。唯一的例外是「工作範圍」這一條,專案不能把它放寬。
專案索引表
底下有哪些專案,一行一個。現在只有一行。
開新專案的流程
以後要加專案時照什麼步驟做,以及專案之間互不干擾。
之後在某個專案裡開工,它會同時讀到上層和這個專案的兩份,不用另外設定。
多出來的兩件事
04它順便回報了兩個發現,而且沒有動手
建完之後,它多講了一段:「我順便發現兩個問題,先回報,沒有動任何東西。」
- 專案說明書裡寫的資料夾名稱,和實際的資料夾對不上。說明書是早先寫的,資料夾後來換過一套結構。它問:要不要把說明書改成和實際一致?
- 專案資料夾裡面,還有一個同名的子資料夾,看起來像不小心多建的。它問:這個要保留嗎?
說明書寫完不會自己更新。資料夾改了、做法變了,那份檔案就開始和現實不一樣,而 AI 每次都照它讀。請 AI 整理一次,常常會把這種落差翻出來。
兩件事它都是先問、沒有先改。上層那份才剛寫進「需要時先問你、不刪檔」。
它自己講的一句提醒
05這份檔案是約定,不是鎖
回覆裡還有一句主動的說明:CLAUDE.md 是寫給它遵守的規則,它會照做,但沒有技術上的強制力,不會真的把其他資料夾鎖起來。
要不要再往下做成真的擋得住,是另一個決定,也是另一篇:「寫了規則」不等於「擋得住」。
帶得走的東西
對每個專案都成立的,寫上層。只屬於這個專案的,寫下層。
講完需求,多問一句「這樣清楚嗎」。
它先說它聽懂了什麼,你就知道接下來會拿到什麼。
留言
CYC 看過才會公開。
還沒有公開的留言。