AGENTS.md 怎麼減少介面廢話？一句英文指令、兩種頁面的測試與取捨
AGENTS.md 怎麼減少介面廢話？一句英文指令、兩種頁面的測試與取捨。帳號設定頁只要讓人修改資料，AI 卻常加上產品介紹、氣氛標語與重複說明。這些文字占掉空間，也讓使用者更難找到操作。
帳號設定頁只要讓人修改資料，AI 卻常加上產品介紹、氣氛標語與重複說明。這些文字占掉空間，也讓使用者更難找到操作。
AGENTS.md 是放在專案中的工作指引檔，可以告訴程式代理這個產品如何命名、寫字及驗收。把介面文案規則放進去，能讓後續修改有共同依據。
我的建議是先刪沒有用途的說明，同時保留錯誤、權限與費用資訊。文字越少是否越好，要看讀者還能不能完成任務。
AGENTS.md 文案規則怎麼寫？
Zihua 的原始貼文 提出用專案指令減少多餘介面文案的做法。它啟發的方向很直接：先讓 AI 從使用者角度寫功能，再檢查每一句是否有用途。
貼文的英文原句分成兩句：
Avoid unnecessary secondary labels and descriptions. Let the layout do the explaining.
意思是避免多餘的次要標籤與說明，讓版面本身幫忙解釋。實際使用時，可以再加一段適合自己產品的限制：
介面文案使用使用者熟悉的名稱。刪除不幫助操作的介紹、口號與重複提示，保留完成任務必須知道的錯誤原因、修改方式、權限及費用。每個按鈕說明按下後會發生的事。
這是本文整理的範例，並非貼文逐字翻譯。AGENTS.md 官方網站 則可用來確認檔案的用途與組織方法。
既有測試有哪些值得保留的發現？
本站 2026 年 11 月 8 日的測試，用 Opus 5.5 對帳號設定頁和產品介紹頁各做有無指令兩組，每組五次，共二十份。指令是加在提示詞前面，並未測試代理實際讀取 AGENTS.md 的流程。
可見文字量以中文字數加上英文單字數的兩倍計算。設定頁中位數從 130 降到 52，介紹頁從 553 降到 245，兩種需求在這次都變短。這是一種比較用的計量方式，並非精確字元數。
副作用也很明顯：附指令的五份設定頁，都刪掉頁面上的不可復原提醒，其中只有三份在確認框保留後果。這表示減字可能同時刪掉必要資訊。
這是特定需求的小樣本，沒有真人可用性測試。文字變短不能直接證明更容易理解，因此規則應明寫要保留不可復原操作的後果。
設定頁和產品介紹頁尤其不同。前者以操作為主，後者需要說清楚產品、適合對象及條件，用同一個字數目標限制兩者，可能刪掉讀者需要的資訊。
修改後怎麼確認沒有刪過頭？
請 AI 同時交一份刪改表，寫明原句、保留或刪除的理由，以及對應的使用情境。你就能看到它是在刪口號，還是把限制條件一起拿掉。
最小驗收可以從三個情境開始：使用者第一次進來、輸入錯誤、完成操作。第一次進來應看得懂要填什麼，出錯時知道怎麼修，完成後也能確認結果。
再檢查按鈕與成功訊息是否用同一個動作名稱。例如按鈕叫「儲存設定」，成功後就清楚寫已儲存，避免突然換成另一套術語。
常見問題
AGENTS.md 是終端機指令嗎？
它是文字指引檔。先確認所用代理如何讀取專案規則，再把內容放到適合的位置。
能要求所有說明都刪掉嗎？
不建議。資料用途、不可逆操作和付費條件會改變使用者決定，應在需要的位置說清楚。
數字變少就算成功嗎？
還要看任務是否完成、錯誤是否能修。字數可以輔助比較，不能代替可用性驗收。
從最吵的一個畫面開始
先改設定頁或表單，保留修改前後的畫面與操作紀錄。當文案少了、主要動作更容易找到，也沒有遺失必要提醒，這條規則才值得留下。
