指令用途

/wait-what 是針對模型冗長的一字修正。在訊息沒到位的那一刻（《等等，什麼？》）打它，代理會把訊息重新表述：

• 一點脈絡 —— 你錯過的背景
• ASD-STE100 簡化技術英文 —— 航空業的受控詞彙，刻意限制用字以求清晰
• 你 CONTEXT.md 的 ubiquitous language —— 你專案的共享詞彙

它只修一則訊息；它不預防下一則。冗長的根治是用 /grill-with-docs 預先建立共享語言；/wait-what 是你還沒有共享語言時的即時補救。

為什麼是「wait-what」這個名字

機制就是名字本身。

簡潔 skills 的失敗在於變長。 一個 400 行的 skill 仍然讓模型冗長 —— 所以這個 skill 是單一、精準的 leading word，沒別的。

描述輸出的名字（/tldr、/no-fluff）會讓模型剪掉字、然後你更迷失 —— 你拿到了更短但更沒脈絡的版本。命名聽者的狀態（「等等，什麼？」）同時要兩半：更少字，且加上你錯過的脈絡。

它也重用你全域 CLAUDE.md 裡已經有的 leading words，所以 skill、CLAUDE.md 和每個 CONTEXT.md 都伸手拿同一組 tokens。

實戰對話範例

範例一：訊息太繞

• AI（一則又長又繞的訊息）:

  關於你問的 materialization cascade，我們可以考慮在 persistence layer 透過 event sourcing 的方式，或者，換個角度，若採取 CQRS pattern 並將 read model 與 write model 分離…

• You:

  /wait-what

• AI:

  你問的是：課程影片「上架」時，系統為什麼會卡。

  一句話版本：上架一支影片時，系統要同時更新選單、搜尋索引、推薦清單 —— 這三件事卡在一起，所以慢。

  要我深談哪一塊？

範例二：術語超載

• AI:

  我們應該把 saga orchestrator 接到 outbox pattern，並確保 idempotency key…

• You:

  /wait-what

• AI:

  你接下來要做的是：讓「訂單成立」這件事，就算系統中斷也不會漏掉或重複。

  兩個簡單做法：

  1. 寫一筆時就蓋印章（只蓋一次）。
  2. 用一個清單記「還沒送出的」，定時補送。

ASD-STE100 簡化技術英文

這是航空維修手冊用的受控英文 —— 刻意限制用字（約 900 字核心詞）、一句一個想法、主動而非被動、禁用模糊修飾。把它用在代理訊息上，逼出：

• 一個句子一個想法 —— 不長句包五件事。
• 主動語態 —— 不「此問題將被處理」，而是「我會處理這個問題」。
• 具體而非抽象 —— 不「適當地配置」，而是「設 timeout 為 30 秒」。

它與你 CONTEXT.md 的 ubiquitous language 疊加 —— 用你專案自己的詞替換通用詞（不是「商品」，而是你 domain 裡的 SKU；不是「使用者」，而是你的 Member）。

何時應該使用

• 訊息沒到位的那一刻：你讀完還是霧煞煞。
• 模型用了太多通用術語，沒用你專案的詞。
• 一句訊息塞了五件事：要拆。

何時不應該使用

• 只是要更短：用 /wait-what 會同時加脈絡，可能不更短 —— 如果你要的就是剪短，自行說「再短一點」。
• 訊息本身沒問題、是你漏看：重讀。
• 長期解方：/wait-what 修一則，不治本。要治本，用 /grill-with-docs 建立共享語言。

重要：這是補救，不是根治

/wait-what 修一則訊息；它不預防下一則。冗長的病根是缺乏共享語言 —— 當模型沒有你的 ubiquitous language 時，它用 20 個字描述 1 個概念。

根治是 /grill-with-docs：它透過追問同時建立你的 domain model，把術語磨利並寫進 CONTEXT.md 與 ADRs。一旦有了那個共享語言，模型會用你的詞，你就少需要 /wait-what。

/wait-what 是你還沒建立共享語言時的即時補救。

與其他技能的關係

/wait-what 是 productivity bucket 的獨立、隨時可用 skill。它的根治夥伴是 /grill-with-docs（建立共享語言，讓 /wait-what 不再需要）。不確定該用哪個 skill 時，用 /ask-matt 來路由。