# CLAUDE.md 加一句英文，AI 做的介面字少一半？A/B 實測數字＋一定要留的「無法復原」

> 在 CLAUDE.md／AGENTS.md 加一句「Avoid unnecessary secondary labels and descriptions」，@cs2pm_ghost 用 Opus 5.5 各跑 5 次：設定頁 130→52 字、產品頁 553→245 字，但刪除帳號的「無法復原」…

- 網址：https://yourjobpocket.com/learn/claude-md-one-line-less-ui-text
- 發布：2026-11-14
- 主題：Claude Code
- 作者：@your.engineer.ben（https://www.instagram.com/your.engineer.ben/）
- 參考來源：https://x.com/luinlee/status/2113085361836744764
- 出處：Lesson by Job Pocket（https://yourjobpocket.com/learn），免費、不用登入

先說結論：在 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 件事

1. **不可逆的動作有沒有寫後果**：刪除帳號、刪除檔案、付款、取消訂閱。按下去會怎樣，畫面上一定要說。
2. **無障礙標籤還在不在**：說明文字刪了沒關係，但 icon 按鈕的 aria-label、圖片的 alt 不能一起消失，不然讀螢幕軟體的使用者會完全不知道這是什麼。
3. **陌生人看得懂嗎**：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

1. 在專案根目錄找 `CLAUDE.md`，沒有就新增一個（Claude Code 裡輸入 `/init` 也會幫你建）。
2. 找一個「介面／設計」的段落，把那一句貼進去。
3. 如果你也用 Codex 或其他工具，可以放在 `AGENTS.md`。新版 Claude Code 也會把 AGENTS.md 當成專案指令讀取（內建的 agents-md mod）。
4. 注意：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
