verbosity-tuner

# Verbosity Tuner — 讓 Claude 講重點，但不吃掉精華 ## 一句話心法 > 「精簡」有兩種切法：**砍字**（caveman，省 token）和 **砍件數**（Concise，省注意力）。 > 抱怨「資訊太多、難專注」的人要的是後者。選錯就是拿降血壓藥治頭痛。 ## 什麼時候用 - 覺得 Claude 每次回覆都要滑很久才找到答案 - 想用 caveman / 極簡風格，但怕把「為什麼」「取捨」「警告」一起壓掉 - 設過 output style 但好像沒生效 - 想在多台機器 / 團隊間統一回覆風格 --- ## Phase 0 — 健檢（先看數字，別憑印象） ```bash bash scripts/audit.sh ``` 輸出六項：版本是否支援 Concise／`outputStyle` 有沒有接線／有沒有 project-level 覆蓋／ style 檔的 `keep-coding-instructions` 有沒有漏／CLAUDE.md 大小／subagent 數量。 **先跑這個。** 最常見的狀況不是「設錯」，是**寫了 style 檔但根本沒啟用**。 --- ## Phase 1 — 認識三個旋鈕（分工不能混） | 旋鈕 | 放什麼 | 力道 | 生效時機 | |---|---|---|---| | 當下一句話 | 這次要什麼格式 | 只管這次 | 立即 | | `CLAUDE.md` | **專案事實、慣例**（不是語氣） | 中——以 user message 注入，排在系統提示後 | 立即 | | **Output Style** | **語氣、角色、預設格式** | **最強**——直接改系統提示 | **要 `/clear` 或新 session** | 鐵律： - 語氣規則放 output style，**不要**塞 CLAUDE.md（會被其他規則稀釋）。 - 專案事實放 CLAUDE.md，**不要**塞 output style（換專案就錯了）。 - 別寫「請簡潔一點」這種模糊指令，**指定確切結構**（先結論／幾行／哪些區塊必留）。 --- ## Phase 2 — 精簡階梯，由輕到重 一次只上一階，用一週再決定要不要加碼。 ### 階梯 1：內建 `Concise`（預設起點，零風險） 需要 Claude Code **v2.1.237+**。 ```bash python3 -c "import json,pathlib; p=pathlib.Path.home()/'.claude/settings.json'; d=json.loads(p.read_text()) if p.exists() else {}; d['outputStyle']='Concise'; p.write_text(json.dumps(d,indent=2,ensure_ascii=False)+'\n')" ``` 它砍旁白與前言、結論放最前面，但**工程工作照樣做滿**，而且官方明文保留： 錯誤報告全文、安全警告、破壞性操作的確認提示。要細節時開口就給。 ### 階梯 2：自訂 style ＝ Concise ＋ 強制「洞察」區塊 當階梯 1 讓你覺得「太乾、學不到東西」時用。範本： ```bash cp references/styles/concise-plus-insight.md ~/.claude/output-styles/ ``` 差別在多一條硬規則：**非瑣碎回覆必須保留「洞察:」區塊**（為什麼／取捨／陷阱／反直覺處）， 且明文寫「寧可整體短，也不能省這一段」。這就是「怕漏掉精華」的正面解法—— 不是少砍，而是**把要留的東西點名寫死**。 ### 階梯 3：caveman（只在目標是省錢時） 電報體壓縮，社群回報輸出 token 少 40–65%。**但它壓的是字數不是件數**， 對「難專注」幫助有限，對中文讀者尤其吃力。純成本考量再上。 --- ## Phase 3 — 四個會讓你白忙的坑 1. **寫了 style 檔 ≠ 啟用。** 一定要在 settings 裡指名 `outputStyle`。 2. **自訂 style 預設會拆掉內建工程指令。** frontmatter 沒寫 `keep-coding-instructions: true`，Claude Code 內建的「怎麼界定改動範圍／怎麼寫註解／ 怎麼驗證自己的產出」會整包消失。**只想改講話方式就一定要加這行**—— 這是唯一「從輸出看不出來、但真的弄丟東西」的坑。 3. **改完不會馬上生效。** output style 只在 session 開始時讀一次，要 `/clear` 或開新 session。 4. **Output style 不套用到 subagent。** subagent 跑自己的 system prompt。 如果噪音主要來自背景 agent 的長篇報告，這裡怎麼調都沒用—— 要去改該 agent 的 `.md`，或在派工 prompt 裡限定回報格式。 （唯一例外是 fork，它繼承母對話的完整系統提示。） --- ## Phase 4 — 驗收（用一週，只問一題） > 「他有沒有把『為什麼這樣做』一起砍掉？」 - 沒砍 → 收工。 - 有砍 → 上一階梯。 - 反而覺得資訊不夠 → 先用**展開手勢**（「展開」「完整版」「詳細說」）， 不要急著把 style 拆掉。精簡砍的是預設長度，不是上限。 --- ## 回滾 ```bash # 看備份 ls -t ~/Documents/claude-backups/ | head # 還原 cp ~/Documents/claude-backups/<那一份>/settings.json ~/.claude/settings.json ``` 或直接把 `outputStyle` 值改回 `"Default"`。 詳細機制、設定優先序與出處見 `references/mechanics.md`。