第四堂共學

規矩寫進 README,為什麼放錯位置:五個可以直接貼給 AI 的提問

「我把希望 AI 每次都照做的規矩寫進 README.md,這樣放對嗎?不對的話要放哪?」夥伴的提問

README 是告示牌,寫再多都只是介紹;AI 要照著走的規矩像水電系統,得放在別的位置。放哪裡,這一篇不回答,給你五個可以整段複製的提問:它開工先讀什麼、本地端是什麼、資料夾怎麼分層、四份 .md 各做什麼、你的規矩該搬去哪。

夥伴把希望 AI 每次都做到的三件事,整整齊齊寫進了 README.md。嚮導看完說:內容不會太多,但是放錯位置了。

第四堂開始前的五分鐘

01那要放在哪裡?

夥伴接著問了這一句。嚮導當場沒有回答,只說了幾個概念,然後就上課了。

這一篇也不回答。下面是五個提問,每一個都可以整段複製,貼給你正在用的 AI。答案請它講給你聽,你再回頭對照嚮導講的那幾個概念。

為什麼不直接給答案:每個人用的 AI 工具不一樣,認的檔名、讀檔的順序也不一樣,而且會改版。學會怎麼問,換了工具還是問得出來。

先講發生了什麼

三條規矩,一份 README

夥伴做的事

02把三件事寫成一份手冊

夥伴的想法很合理:README 的意思是「先讀我」,那 AI 開工前應該會先讀它,所以把規矩寫在這裡。寫了三個部分:

只碰這裡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 看過才會公開。

還沒有公開的留言。

看其他教材

留言