CLAUDE.md 加一句英文,AI 做的介面字少一半?A/B 實測數字+一定要留的「無法復原」
先說結論:在 CLAUDE.md(或 AGENTS.md)加一句英文,AI 做出來的介面,畫面上的字真的會少很多,有的頁面少一半以上。但它也會順手刪掉一些「不該刪」的字,例如刪除帳號底下那行「無法復原」。這篇整理原句出處、@cs2pm_ghost 做的 A/B 實驗數字、我們自己跑的一次結果,以及加了之後一定要檢查的地方。
原句出處:X @luinlee(2026/10/22)https://x.com/luinlee/status/2113085361836744764 實驗來源:IG @cs2pm_ghost(產品經理的背後靈)2026/11/7 的 reel,實驗整理於 11/8
一、就是這一句
Avoid unnecessary secondary labels and descriptions. Let the layout do the explaining.
翻成中文大概是:「避免不必要的副標題和說明文字,讓版面自己把事情說清楚。」
為什麼會需要這句?用 Claude、Codex 做過介面的人應該都有感:AI 很愛在每個區塊下面加一行灰色小字解釋這個區塊在幹嘛,每個開關旁邊再加一句說明,標題下面再來一個副標。單看每一句都沒錯,全部加起來,畫面就變得又擠又囉嗦,真正的按鈕反而被淹沒。
@luinlee 的建議是:把這句放進專案的指令檔(Claude Code 讀 CLAUDE.md,Codex 和很多工具讀 AGENTS.md),讓 AI 每次做介面都記得「少即是多」。
二、cs2pm 的實驗:加跟不加,各跑 5 次
原貼文沒有附前後對照,所以 @cs2pm_ghost 自己做了 A/B 實驗。條件是:
- 模型:Opus 5.5
- 兩個需求:帳號設定頁、產品介紹頁
- 加這句、不加這句,各跑 5 次
- 量的是「頁面上看得見的文字」字數,取中位數
結果:
| 頁面 | 不加 | 加了 |
|---|---|---|
| 帳號設定頁 | 130 字(69–134) | 52 字(50–54) |
| 產品介紹頁 | 553 字(453–563) | 245 字(237–256) |
另外幾個觀察:
- 設定頁的說明句:從 3 句變成 0 句。
- 按鈕、欄位、開關的名稱:20 份頁面都沒有缺。也就是說,它刪的是說明,不是功能。
- 但是:「刪除帳號」底下那行「無法復原」,加了這句的 5 份頁面全部都沒有。按下去之後的確認視窗,5 份裡有 3 份還有寫後果。
最後這點非常重要。「無法復原」不是多餘的說明,它是使用者做出不可逆決定前最後的提醒。AI 照著「刪掉多餘說明」的指示做,卻分不出哪些說明是必要的。
實驗的限制(cs2pm 自己寫在說明欄):只測 Opus 5.5、兩個需求、中文、各 5 次;這句是放在提示詞最前面「模擬」專案指令,沒有用 Claude Code 自動載入檔案驗證,也沒有測 GPT。所以這是一次實驗的結果,不能推論到所有模型和專案。
三、我們自己也跑了一次
我們想看看換一個模型會不會一樣,所以用 Sonnet、同一個需求(帳號設定頁:個人資料、通知開關、密碼變更、刪除帳號)、同樣把這句放在提示詞最前面,加跟不加各跑一次。
- 不加:畫面上看得見的字 488 個,頁面高度約 2,400px。每個區塊都有灰色說明,頭像旁邊寫了建議尺寸,密碼欄下面有強度提示,刪除區列了四點會被刪掉的資料。
- 加了:102 個字,頁面短了快 400px。區塊只剩標題、欄位和按鈕,開關旁邊沒有任何說明。
差距比 cs2pm 的更大,可能是因為 Sonnet 不加的時候本來就寫得比較多。
刪除帳號那一區,我們這次的「加了」版本有留下一行「刪除後所有資料將永久移除,無法復原」。但我們只跑一次,cs2pm 跑 5 次都沒了,所以不能說它會留下,只能說「這次剛好有」。
小插曲:「加了」版本的範例資料,Sonnet 自己填了一個看起來像真人的姓名和 Email。做 demo 截圖時記得檢查,不要把真的個資截出去。
四、加了之後,一定要檢查的 3 件事
- 不可逆的動作有沒有寫後果:刪除帳號、刪除檔案、付款、取消訂閱。按下去會怎樣,畫面上一定要說。
- 無障礙標籤還在不在:說明文字刪了沒關係,但 icon 按鈕的 aria-label、圖片的 alt 不能一起消失,不然讀螢幕軟體的使用者會完全不知道這是什麼。
- 陌生人看得懂嗎:cs2pm 建議的驗收方法很實用,把頁面給一個沒看過的人,請他說說「每個按鈕按了會怎樣」。說不出來的地方,就是被刪過頭的地方。
你也可以把第 1、2 點直接寫進指令檔,跟那一句放在一起:
Avoid unnecessary secondary labels and descriptions. Let the layout do the explaining.
Always keep: consequences of irreversible actions (delete, pay, cancel), accessibility labels, and error messages.
第二行是我們加的保險,還沒有像 cs2pm 那樣做過 5 次的實驗,請自己驗證效果。
五、怎麼加進 CLAUDE.md
- 在專案根目錄找
CLAUDE.md,沒有就新增一個(Claude Code 裡輸入/init也會幫你建)。 - 找一個「介面/設計」的段落,把那一句貼進去。
- 如果你也用 Codex 或其他工具,可以放在
AGENTS.md。新版 Claude Code 也會把 AGENTS.md 當成專案指令讀取(內建的 agents-md mod)。 - 注意:CLAUDE.md 是在 session 開始時讀的,對話進行到一半才改,要開新的 session 才會生效。
這週做一件事
把這句加進你的 CLAUDE.md,請 Claude 重做一個你常用的頁面,然後找一個沒看過的人,問他每個按鈕按下去會怎樣。
資料來源:X @luinlee 原句(2026/10/22);IG @cs2pm_ghost 實驗(Opus 5.5,各 5 次,2026/11/8 整理);我們的實測(Sonnet,各 1 次,2026/11/14)。原貼文與實驗數字以原作者公布為準。
想把 Claude Code 從安裝到每個畫面都搞懂?《Claude CLI 實機圖解》NT$199:https://yourjobpocket.com/lessons/claude-code-atlas
參考來源:x.com


