# 性能優化 (Performance Optimization)

## 模型選擇策略

**Haiku 4.5** (具備 Sonnet 90% 的能力，節省 3 倍成本)：
- 需要頻繁呼叫的輕量級 Agent。
- 結對編程 (Pair programming) 與程式碼生成。
- 多 Agent 系統中的工作者 Agent。

**Sonnet 4.6** (最佳編碼模型)：
- 主要開發工作。
- 編排多 Agent 工作流。
- 複雜的編碼任務。

**Opus 4.5** (深度推理)：
- 複雜的架構決策。
- 最高的推理需求。
- 研究與分析任務。

## 上下文視窗管理

針對以下情況，避免使用上下文視窗的最後 20% 空間：
- 大規模重構。
- 跨越多個檔案的功能實作。
- 偵錯複雜的互動。

後續對上下文敏感度較低的任務：
- 單一檔案編輯。
- 獨立工具 (Utility) 建立。
- 文件更新。
- 簡單的錯誤修復。

## 擴展思考 (Extended Thinking) + 規劃模式 (Plan Mode)

擴展思考預設為啟用，保留最多 31,999 個 token 用於內部推理。

透過以下方式控制擴展思考：
- **切換**：Option+T (macOS) / Alt+T (Windows/Linux)。
- **配置**：在 `~/.claude/settings.json` 中設定 `alwaysThinkingEnabled`。
- **預算上限**：`export MAX_THINKING_TOKENS=10000`。
- **詳細模式**：Ctrl+O 以查看思考過程輸出。

針對需要深度推理的複雜任務：
1. 確保已啟用擴展思考（預設開啟）。
2. 啟動 **規劃模式 (Plan Mode)** 以獲得結構化的方法。
3. 進行多輪批評 (Critique rounds) 以達成透徹的分析。
4. 使用分工明確的子 Agent 來獲得多元觀點。

## 建置疑難排解

若建置失敗：
1. 使用 **build-error-resolver** agent。
2. 分析錯誤訊息。
3. 採用增量修復。
4. 每次修復後進行驗證。
