模型路由與 token 節省
使用哪個模型
- Sonnet（預設，約 90% 的工作）： 編輯、除錯、測試、重構已知程式碼、git、文件、README/TROUBLESHOOTING 更新、執行
npm run check。 - Opus（僅在值得時使用）： 跨多個模組的新功能、架構或資料流程變更、Sonnet 嘗試一次後仍未知原因的錯誤、安全審查、大規模遷移。用它產出簡短的書面計畫（最多約 30 行），然後在 Sonnet 上執行該計畫。
- Haiku： 純查詢、grep 並回報、彙總日誌、列出檔案。透過子代理委派，並使用
model: haiku。 - 不要為了風格、命名或單一檔案變更而升級到 Opus。如果 Sonnet 嘗試失敗兩次，升級一次，然後回到 Sonnet。
在不損失品質的情況下節省 token
- 先讀取
PLAN.md。然後只讀取任務涉及的檔案。在開啟檔案前先使用 Grep/Glob；讀取行範圍，而非整個檔案。 - 永遠不要讀取
node_modules、dist-electron、release、logs、data、package-lock.json或.env。 - 在最後執行一次
npm run check，而不是每次編輯後都執行。在疊代過程中執行單一測試檔案（npx vitest run tests/<file>）。 - 將較長的命令輸出透過
Select-Object -First 40/-Last 40管線傳遞；不要傾印完整的日誌。 - 不要重新讀取剛編輯過的檔案。不要重複對話中已確認的事實。
- 保持回覆簡潔：變更了什麼、驗證了什麼、使用者下一步需要做什麼。
- 將廣泛的搜尋或日誌讀取卸載給子代理，這樣只有其結論會進入主上下文。
- 每個工作階段處理一個任務。當主題改變時，開始新的工作階段，而不是攜帶較長的歷史記錄。
- 切勿為了節省 token 而跳過檢查、測試或讀取影響正確性的檔案。