規矩寫進 README,為什麼放錯位置:五個可以直接貼給 AI 的提問
「我把希望 AI 每次都照做的規矩寫進 README.md,這樣放對嗎?不對的話要放哪?」夥伴的提問
README 是告示牌,寫再多都只是介紹;AI 要照著走的規矩像水電系統,得放在別的位置。放哪裡,這一篇不回答,給你五個可以整段複製的提問:它開工先讀什麼、本地端是什麼、資料夾怎麼分層、四份 .md 各做什麼、你的規矩該搬去哪。
夥伴把希望 AI 每次都做到的三件事,整整齊齊寫進了 README.md。嚮導看完說:內容不會太多,但是放錯位置了。
第四堂開始前的五分鐘
01那要放在哪裡?
夥伴接著問了這一句。嚮導當場沒有回答,只說了幾個概念,然後就上課了。
這一篇也不回答。下面是五個提問,每一個都可以整段複製,貼給你正在用的 AI。答案請它講給你聽,你再回頭對照嚮導講的那幾個概念。
為什麼不直接給答案:每個人用的 AI 工具不一樣,認的檔名、讀檔的順序也不一樣,而且會改版。學會怎麼問,換了工具還是問得出來。
先講發生了什麼
三條規矩,一份 README
夥伴做的事
02把三件事寫成一份手冊
夥伴的想法很合理:README 的意思是「先讀我」,那 AI 開工前應該會先讀它,所以把規矩寫在這裡。寫了三個部分:
而且希望以後換了別的 AI,它也得照這三件事做。
嚮導講的概念
03告示牌,和水電系統
嚮導沒有說該放哪,只說了三件事:
README 是告示牌
第一次走進一個可以自由參觀、又沒有人接待的地方,你會到處逛,然後一張一張讀牆上的告示、作品旁邊的小卡。README 就是那些牌子。
範圍你決定
一張牌子可以介紹一幅畫,也可以介紹一整棟樓。以一個資料夾為單位,或以一整個專案為單位,看你要它管多大。
規矩像水電系統
AI 工作時要遵守什麼規則、什麼習慣,是另一回事。那比較像一棟樓的電力和水力系統:它得順著那套邏輯運作。
README 是簡介。它寫得再多,都是在介紹,本身不會發生作用。希望有作用的東西,要放在別的位置。
README 不分工程師或其他角色。誰走進來,誰就讀它。
換你問
五個提問
照順序問。前三個問它怎麼運作,第四個問那幾份檔案,第五個才回到你自己的資料夾。
提問一
04你每次開工,會先讀到什麼?
規矩要放哪,取決於它開工時會讀哪裡。所以先問這個。
我不是工程師,正在學怎麼跟 AI 一起工作。想先弄懂你是怎麼運作的。 請告訴我:每一次我開一個新的對話,你開始工作的那一刻,手上有哪些資訊? 請分成三類: 1. 我什麼都沒做,你就一定會讀到的 2. 你判斷有需要、或我叫你去讀,你才會讀的 3. 你讀不到的 每一類舉一個生活化的例子。 另外請回答:上一次對話我跟你講過的事,這一次你還記得嗎?如果不記得,要靠什麼才接得上? 如果答案會因為我用的工具不同而不一樣,請先問我用的是哪一個。 不確定的地方請直接說不確定,不要猜。
讀回答的時候留意:它說「一定會讀到」的東西裡,有沒有提到任何檔案。
提問二
05在網頁上聊天,跟在我電腦裡工作,差在哪?
「本地端」這個詞常常出現。請它用你聽得懂的方式講。
同樣是你,有兩種用法: A. 我在瀏覽器的聊天視窗跟你對話 B. 你在我自己電腦的某個資料夾裡工作(有人叫這個「本地端」) 請用一張對照表比較 A 和 B: - 你看得到我電腦上的哪些東西 - 你能不能動手建立、修改、刪除檔案 - 哪些動作你會先問過我才做 - 我的檔案內容會被送到哪裡、留在哪裡 - 對話結束之後,留下來的東西在哪裡 表格後面,請用一個日常生活的比喻,各用一句話形容 A 和 B。 最後告訴我:B 這種用法,我最應該小心的一件事是什麼。
讀回答的時候留意:哪一種用法,做完的東西會留在你自己的電腦上。
提問三
06為什麼要「在某個資料夾裡」打開你?
嚮導說牌子可以小到一幅畫、大到一棟樓。資料夾也是一層包一層。問它每一層是怎麼算的。
我聽說跟你工作的時候,要先選一個資料夾,在那個資料夾裡打開你。 請解釋: 1. 我在哪一個資料夾打開你,對你來說有什麼差別? 2. 資料夾裡面還有子資料夾。如果最外層放了一份說明,子資料夾裡也放了一份,你兩份都會讀嗎?內容互相衝突的時候,你聽誰的? 3. 我的電腦上有很多個專案。有沒有一個地方,放一份說明就能讓每個專案都適用? 請把一棟樓、樓層、房間當作比喻,用文字畫一張樹狀圖給我看,標出每一層可以放什麼說明、那份說明管到哪裡。 畫完之後,請反問我兩個問題,幫我想清楚我自己的資料夾該怎麼分。
讀回答的時候留意:同樣一句規矩,放在外層和放在內層,管到的範圍一不一樣。
提問四
07這四份檔案,各自是做什麼的?
資料夾裡會看到好幾種全大寫檔名的 .md。名字很像,請它一次分清楚。
我在別人的專案資料夾裡看過這幾個檔案: README.md、CLAUDE.md、AGENTS.md、SKILL.md 請做一張表,每個檔案一列,欄位是: - 一句話說明它是什麼 - 主要寫給誰看(人,還是 AI) - 你會不會自動去讀它?在什麼時候讀? - 寫在裡面的內容,是「介紹」還是「你會照著做的規矩」 - 哪些 AI 工具認得這個檔名 表格之後請回答: 1. 有人形容其中一份像「告示牌」,另外幾份像一棟樓的「水電系統」。你覺得哪一份是告示牌?為什麼? 2. 如果我以後會換不同的 AI 工具,哪一份最能讓每個工具都讀得到? 這些檔名的規則各家工具不一樣,而且會改。請上網查各家官方文件的最新說法,附上來源,並標出你查的日期。
讀回答的時候留意:「它會不會自動讀」和「它會不會照做」是兩個欄位,答案不一定相同。
提問五
08我的三條規矩,各自該放在哪裡?
回到開頭那個沒有回答的問題。這一題請在你自己的專案資料夾裡問,它才看得到你現在的檔案。三條規矩可以換成你自己的。
請先讀這個資料夾裡現有的 README.md,以及其他寫給 AI 看的說明檔。先不要修改任何檔案。 我有三件事,希望每一次跟 AI 工作它都做到: 1. 只能取用這一個資料夾,其他地方不可以碰 2. 每次開工前,先讀上一次的進度,接著做 3. 做完要自我檢查;沒完成或有異常,要老實回報,不能說「已完成」 我原本把這三件事都寫在 README.md。有人跟我說內容沒問題,但是放錯位置了。 請你告訴我: - 這三件事,每一件應該放在哪一個檔案或哪一種設定裡?為什麼? - 哪幾件只要寫成文字你就會照做?哪幾件光寫文字不夠,要靠工具的設定才真的擋得住? - README.md 裡應該留下什麼? - 如果我以後換成別家的 AI,怎麼安排才不用整份重寫? 先給我一份搬移計畫,一步一步列出來,等我說可以再動手。 搬完之後,請設計三個小測試,讓我親眼確認每一件事真的有生效。
讀回答的時候留意:它有沒有把「約定」和「擋得住」分開講。沒有的話,追問一次。
怎麼問
五個提問,用的是同一種寫法
拆開來看
09一個提問裡放了五樣東西
回頭看上面任何一題,都找得到這幾樣。以後問別的事,照這個順序填就可以。
拿到回答之後
10四句可以接著問的話
第一次的回答看不懂很正常。不用重新想一個提問,接下面任何一句就好:
這一段我聽不懂。請換一個比喻,再講一次。
請用我自己這個資料夾當例子,再講一次。
你剛剛講的內容,哪些是你查證過的,哪些是你推測的?請分開列。
請出三個小問題考我,看我是不是真的懂了。我答錯的地方再講一次。
問完再對照
11先前課堂留下的幾篇
這幾篇是前幾堂整理的,裡面有當時 AI 給的說法。建議先問完上面五題,再回來讀,看看你的 AI 講的和這裡寫的有哪裡不一樣。
帶得走的東西
不知道該放哪,就問它:你開工的時候,會讀哪裡?
然後請它查證,請它等你說可以再動手。
五題問完,把你覺得最意外的一個回答帶來,下次一起看。
留言
CYC 看過才會公開。
還沒有公開的留言。