什麼是 /btw 指令？

讓開發者在不中斷當前推理鏈與任務執行的前提下，將重要背景資訊以「旁白補充」的方式安全送入待處理輸入佇列（Pending Input Queue）。

為什麼要用 /btw？

當我們指示 AI 代理執行一項複雜的長跑任務時（例如：掃描全專案、執行重構測試、建置依賴套件），開發者經常遇到三大痛點：

1. 突然想起關鍵限制條件：任務開始後才想起「後端 Node.js 版本是 18 不能用新 API」或「密鑰其實定義在 .env.production 裡面」。
2. 強制中斷（Ctrl + C）的巨大代價：傳統命令列工具中，想補充資訊只能強制中斷，導致剛才累積的推理脈絡全部付諸流水，一切必須從頭再來。
3. 默默等待的無奈與浪費：若等到全部做完才在下一輪糾正，AI 可能已經往錯誤方向改了十幾個檔案，後續需要耗費更多權杖（Tokens）去回滾和重新修正。

/btw 徹底終結了這種「補充焦慮」，讓你能隨時在旁邊優雅遞便利貼。

/btw 的底層運作原理長怎樣？

1. 訊息佇列與非同步注水機制

在 Antigravity CLI 的底層執行循環中，代理的思考與工具呼叫是一個連續的狀態機（State Machine）。

/btw 並不是硬生生地打斷執行緒，而是將訊息送入專屬的非同步輸入佇列：

┌──────────────────────────────────────────┐
│ 開發者輸入：/btw 注意 Python 版本為 3.11 
└──────────────────────────────────────────┘
                     │ (送入待處理佇列)
                     ▼
┌──────────────────────────────────────────┐
│ 非同步輸入佇列 (Pending Input Queue) 
└──────────────────────────────────────────┘
                     │
                     ▼ (自動掛載於步驟間隙)
┌──────────────────────────────────────────┐
│ 【代理核心執行迴圈】     
│                                       
│ 1. 正在執行工具       
│ │                                     
│ ▼                                     
│ 2. 工具執行完畢，準備進入下一輪思考 
│ │                                     
│ ▼                                     
│ 檢查輸入佇列中是否有 /btw 訊息？ 
│ │
│ ├── [是] ──► 將補充資訊注入 Context
│ │                 │                     
│ │                 ▼                     
│ │       3. 結合最新補充條件，修正後續執行路徑
│ │                                     
│ └── [否] ──► 正常繼續推理下一個動作
└──────────────────────────────────────────┘

2. /btw 與一般使用者輸入有何不同？

【一般使用者輸入 (Normal Input)】
┌──────────────────────────────────────────┐
│ 1. 終端機輸入新問題
└──────────────────────────────────────────┘
                     │ (必須等待當前工作完全結束)
                     ▼
┌──────────────────────────────────────────┐
│ 2. 開啟全新的一輪對話回合
└──────────────────────────────────────────┘

【/btw 旁白補充】
┌──────────────────────────────────────────┐
│ 1. 終端機輸入 /btw 補充說明
└──────────────────────────────────────────┘
                     │ (不打斷現有推理鏈)
                     ▼
┌──────────────────────────────────────────┐
│ 2. 於當前任務的工具切換間隙中被即時吸收
└──────────────────────────────────────────┘

1. 一般輸入：代表任務交替，代理會將其視為新的獨立回合，並等待當前所有工作完全終止。
2. /btw 輸入：代表旁白提示（Side Note），代理在執行當前任務的每一個工具切換間隙（Tool Boundary），都會檢查是否有旁白提示，並即時納入推理考量。

/btw 怎麼用？

1. 指令基本語法

在 Antigravity CLI 提示字元中，語法非常直覺：

/btw <您想補充的背景說明、環境限制或提醒>

2. 實作演練示範

場景：代理正在進行大型 API 重構，開發者補充相容性限制

假設你剛剛對代理下達了重構任務：

請幫我將專案中所有使用 axios 的 HTTP 請求模組，全面重構改用原生 fetch API。

代理開始逐一掃描 src/api/ 目錄下的數十個檔案並進行修改。

此時，你突然想起後端回應的資料格式有特殊的加密封裝，於是你立刻在終端機輸入：

/btw 請特別注意：後端回傳的 JSON 根節點皆包含 { code, data, message } 封裝，重構時請確保保留原本對 response.data.data 的解構邏輯。

代理在終端機中的反應時序

1. 代理正在修改 src/api/user.ts，並沒有因為你的輸入而中斷報錯。
2. 完成 user.ts 後，代理在思考日誌中顯示：[接收到旁白補充資訊]：後端回傳結構需保持 { code, data, message } 解構。
3. 代理自動調整接下來對 src/api/order.ts 與 src/api/product.ts 的重構程式碼，精準保留了資料解構層！
4. 最終回報：「已完成所有 API 重構，並依據您補充的旁白限制，完整保留了後端響應資料結構！」

/btw 可以當成聊天室狂發嗎？

1. 適合使用 /btw 的黃金時機：
   • 補充環境限制（如 Node.js 或 Python 版本、作業系統差異）。
   • 補充檔案路徑或設定檔名稱（如「對了，密鑰在 .env.local」）。
   • 補充非核心業務邏輯的細節提醒。
2. 不適合使用 /btw 的時機：
   • 完全改變任務方向：如果你原本要代理寫登入模組，突然決定改成做購物車，這時不應使用 /btw，而應該果斷按 Ctrl + C 或使用 /rewind 重新下達目標。
3. 避免過度瑣碎的頻繁輸入：
   單一長任務中輸入 1~2 次關鍵 /btw 能達到最佳協同效果；若頻繁輸入過多相互矛盾的旁白，可能導致代理在推理時產生權重衝突。