iT邦幫忙

2026 iThome 鐵人賽

DAY 4
0

摘要
這篇文章透過實測說明,每次開啟新對話都重新交代工作規則非常耗時,而 AGENTS.md 就是為解決這個痛點所存在的。它就像是給 AI 的入職懶人包,用來記錄專案的常態工作習慣與預設格式,有別於僅適用單次任務的提示詞。作者透過 Google 行事曆實測發現,若只在對話中要求 AI 加上特定 emoji,開啟新對話後 AI 就會馬上遺忘。但只要將這項規則統整寫入 AGENTS.md,AI 在新對話啟動時就會自動讀取並套用格式,無需我們反覆提醒。因此,作者建議不需要一開始就試圖寫出完美的設定檔,而是讓它隨著實際工作逐步成長。當你發現同一個指令被重複交代了兩次以上,就是將該規則提煉並加入這份檔案的最佳時機。

引言

如果你每次開一個新的對話,都還要跟 ChatGPT 重新解釋一次「檔案怎麼命名」、「哪些事情不要自己猜」、「最後要怎麼整理」,那你其實一直在重複做同一件事:重新教 AI 怎麼跟你工作

但我後來發現,這些事情其實不一定要每次重講。你可以把常用的工作偏好整理成一份 AGENTS.md,放進專案裡。原本每次都要重新交代的規則,整理一次之後,之後的工作可以繼續沿用。

所以這篇我會實際測一次:同一項工作習慣,只留在對話裡會發生什麼?把它寫進 AGENTS.md 之後,新的對話又會有什麼差別?最後你會得到一個很簡單的判斷方式:哪些話只需要這次告訴 AI,哪些話已經值得讓之後每一次合作都知道。

Day4_cover image


具體來說,AGENTS.md 是什麼?

如果要用一句話理解 AGENTS.md,我會把它想成 AI代理 進入一個專案時拿到的「入職懶人包」。

第一次看到 AGENTS.md,很容易以為它是一種新的程式語言或特殊設定檔。其實它就是一份 Markdown 文件,用來記錄 AI 代理開始工作前應該知道的事情。這就像新同事第一天報到。除了眼前的任務,他也需要知道團隊平常怎麼工作,以及遇到不確定的事情時該怎麼處理。

AGENTS.md 做的事情很像:把原本存在腦袋裡的工作習慣,整理成一份 AI 代理看得懂的工作手冊。

這些規則寫下來之後,下一次 AI 代理進入專案時,就能先了解這裡平常怎麼做事,不必每次都從頭交代。

💡 小知識|AGENTS.md 跟提示詞有什麼差別?
提示詞比較像「今天要做什麼」,AGENTS.md 則是在說「在這個專案裡,平常應該怎麼做」。 今天的任務可能是整理資料、修改文章或檢查程式碼,但像「不要覆寫原始檔」、「不知道的資訊不要自己猜」、「輸出要遵循固定命名方式」,通常不需要每次重新交代,因為這些描述的是工作慣例,而不是單次任務。

ChatGPT Work 會怎麼使用 AGENTS.md?

每當你在專案當中啟動一個新的對話時,ChatGPT work 第一件事情就是去讀取 AGENTS.md 檔案,如果這份檔案在的話。意味著如果有經常重複使用的指令、文件要求、語氣等,而你希望每次對話時候,ChatGPT 可以記住的話,並且一直遵循,就可以把這些要求放入 AGENTS.md 。

第一次:它會怎麼幫我安排?

我先從最日常的情境開始。我只告訴 ChatGPT Work:「幫我在 Google Calendar 安排 9 月 19 日下午 3 點的『Day 5 鐵人賽文章討論』。」沒有先準備一大串 Prompt,也沒有告訴它我平常怎麼整理這類行程,我就是想看看,只給這些資訊會發生什麼。

沒有AGENTS-對話
〔截圖 1:第一次只提供日期、時間與活動名稱,請 ChatGPT Work 安排行程〕

ChatGPT Work 很快就把活動準備好了,但它沒有直接寫進 Calendar,而是先把準備建立的內容列給我看,再問:「要我現在按下建立嗎?」

看到這裡,我沒有馬上說好。因為當內容真的擺在眼前時,我立刻想到一個自己的習慣:既然這是一場文章討論,我希望標題前面有一個 📄,讓我之後掃過 Calendar 時,一眼就知道這是哪一類工作。

所以我又補了一句:「建立,然後標題需要有文件 emoji。」

沒有AGENTS-對話補充細節
〔截圖 2:看到準備建立的內容後,我再補充「標題需要有文件 emoji」〕

這一次,ChatGPT Work 按照我剛補上的要求完成建立。

但我還是想確認一件事:**它是真的寫進 Google Calendar 了,還是只在對話裡告訴我「完成」?**於是我直接切回 Calendar 檢查。

沒有AGENTS-對話完成行事曆
〔截圖 3:回到 Google Calendar,確認「📄 Day 5 鐵人賽文章討論」已實際建立〕

行程真的出現了,標題也按照剛才補充的要求加上 📄。

第一次測試順利完成,但也留下了一個問題。這個剛剛補上的偏好,換到新的 session 之後還會保留嗎?
為了確認這件事,我重新開啟對話,交付幾乎相同的任務,這次不再提醒它加上 📄。

第二次測試:換一個新對話,剛才的規則還在嗎?

好,第二次我們換了一個新的對話。這次我刻意把條件縮回最一開始的樣子,只告訴 ChatGPT Work:「幫我在 Google Calendar 安排 9 月 20 日下午 3 點的『Day 6 鐵人賽文章討論』。」前一次才剛提醒過「文章討論的標題前要加 📄」,所以我其實有一點期待:既然還在處理同一類工作,它會不會順手把這個習慣沿用下來?

沒有AGENTS-新對話
〔截圖 4:開啟新的 對話,再次要求建立相同類型的文章討論行程〕

ChatGPT Work 很快準備好活動,時間、標題、日曆都列了出來。這次我沒有再補充任何細節,直接按下「儲存」。接下來才是我真正想看的地方:如果前一次的修正真的有留下來,那 Google Calendar 裡的標題,應該會自己帶上 📄 才對。

於是我切回 Google Calendar。

沒有AGENTS-新對話完成行事曆
〔截圖 5:第二個 對話 建立完成後,回到 Google Calendar 檢查結果〕

結果很直接:沒有

行程確實建立成功,時間也是下午 3 點到 4 點,標題卻只有「Day 6 鐵人賽文章討論」。這表示前一次補充的偏好只留在當時的對話裡,換到新的對話後,它沒有自動成為下一次也會遵守的規則。如果我希望「文章討論一律加上 📄」可以持續生效,就得把它寫進專案裡。

接下來,輪到 AGENTS.md 上場了。

把重複出現的偏好寫進 AGENTS.md

前一次換到新的對話 後,📄 沒有跟著出現。既然問題已經找到了,這次就不再靠對話提醒,而是把這些習慣真正寫進工作資料夾裡。

我先建立一份 AGENTS.md。不過,我沒有直接寫下「Day 6 的標題要加 📄」,因為那只對這一次任務有用。我把需求往上整理成一類工作:只要是腦力激盪、概念發想、內容架構或寫作,都視為「創作時段」。建立這類 Calendar 行程時,標題加上 📄,備註留下這次創作的目標;沒有提供參與者、地點或 Google Meet,就不要自行補上。

有AGENTS-本體
〔截圖 6:在工作資料夾建立 AGENTS.md,將「創作時段」的行事曆慣例寫進去〕

規則放好之後,我重新開一個 對話,再做一次相同的測試。這次沒有提醒要加 📄,也沒有特別叫它讀 AGENTS.md,只是照平常的方式請 ChatGPT Work 建立文章討論行程。

💡 補充:完整 AGENTS.md 範例
我會把這次使用的版本放在 GitHub Repo,方便想實際測試的人直接取用,再依自己的工作方式修改。

接著回到 Google Calendar 看結果。

有AGENTS-行事曆成功
〔截圖 7:新的 對話 沒有再次補充規則,建立出的行程已套用創作時段慣例〕

這次,📄 出現了,備注也自動留下「完成 Day 6 鐵人賽文章的內容討論與架構確認」。

前一次,我必須在對話裡補充這些細節;換一個 對話 之後,它們就消失了。現在,我沒有再重新交代,同一組工作方式卻被帶進新的任務裡。

這也是我認為 AGENTS.md 最值得理解的地方:它留下的不是某一次任務,而是下一次還會用到的工作約定。

之後如果我又發現自己反覆修正同一件事,就可以用同樣的方法把它補進來。久了之後,這份檔案自然會變成一套真正屬於自己的工作規則。

💡 經驗分享|什麼時候具體該建立 AGENTS.md?
如果注意到同一個超長提示詞,或是指令要求,已經打第二次以上,就值得考慮放進 AGENTS.md 當中

讓 AGENTS.md 隨著工作慢慢長大

做到這裡,你可能也會想到下一個問題:既然 AGENTS.md 可以留下工作規則,那是不是乾脆一開始就花一兩個小時,把所有偏好、工具設定和工作流程全部寫進去?

做完前面的 Calendar 實驗後,我不打算這樣做。像「創作時段的標題前要加上 📄」這項偏好,就是實際建立行程後才出現的。直到換了新的 session,我才確認它不是當下的臨時要求,而是之後還會用到的習慣。

所以,我會讓 AGENTS.md 隨著工作慢慢長大。每次遇到需要修正的地方,先把眼前的任務做好。相同情況再次出現時,再決定是否把它留下來。

用反覆修正,判斷哪些內容值得進入 AGENTS.md。

結論

AGENTS.md 不需要一開始就寫得很完整,它可以隨著實際工作慢慢長大。當你發現同一項要求已經說了不只一次,就值得考慮把它留下來。這些累積下來的規則,能讓 AI 代理更快進入狀況,也減少每次重新交代的時間。用反覆修正,判斷哪些內容值得進入 AGENTS.md。


本篇內文示範用AGENTS.md都在比賽用專案中,記得隨時關注比賽用專案


上一篇
【Day 3】從聊天到專案:用 ChatGPT Work 接手整個工作資料夾
下一篇
【Day 5】從預設模式到思考預算:看懂 ChatGPT 的模型與推理強度
系列文
2026 年,會用 AI 不等於會帶 AI:用 ChatGPT × Codex 從零開始實現一人 AI 團隊5
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言