🧭 Roo Code 各模式功能筆記

1. 🧑‍💻 Code Mode（程式撰寫模式）

• 用途：協助撰寫、補全、優化程式碼。

• 特性：

  • 適合撰寫 Controller、Service、Validator、Model 等實作內容。

  • 支援單一函式撰寫、模組切分、元件建議。

  • 搭配 Roo 的選取區塊能快速補齊函式內容或範本。

• 常見使用情境：

  • 建立 RESTful API 控制器。

  • 撰寫 Lucid ORM 的 model 與關聯設定。

  • 實作資料驗證（schema-based）。

---

2. 🐞 Debug Mode（偵錯模式）

• 用途：協助分析錯誤訊息、Log、stack trace、HTTP response 問題。

• 特性：

  • 擅長判讀 Exception 堆疊、型別錯誤、API 請求失敗原因。

  • 可分析 Blade 或 TS 檔中造成渲染異常的區段。

  • 特別適用於 Laravel / AdonisJS 的錯誤格式。

• 常見使用情境：

  • E_VALIDATION_FAILURE、QueryException 解析。

  • API 錯誤返回格式診斷。

  • Email 樣板因瀏覽器解釋錯誤導致顯示異常。

---

3. 🧠 Architect Mode（架構設計模式）

• 用途：分析程式架構、建議模組拆分與依賴管理。

• 特性：

  • 以系統設計觀點提供模組命名、資料流與檔案結構建議。

  • 熟悉 DDD、MVC、Service Layer 模式。

  • 可協助整理大型專案的 Controller/Service 分工。

• 常見使用情境：

  • 規劃中大型系統架構（如會員模組、訂單流程等）。

  • 提議如何將 fat controller 拆分為 service 與 repository。

  • 建立適合 CI/CD 的模組邏輯分離。

---

4. 🔁 Orchestrate Mode（任務協調模式）

• 用途：整理工作項目、拆解任務、協助排程與同步。

• 特性：

  • 能將複雜的開發流程拆解為步驟。

  • 擅長輸出「代辦事項」或「開發計畫清單」。

  • 可搭配 Git workflow 提供分支規劃建議。

• 常見使用情境：

  • 功能開發規劃與同步（如前後端整合流程）。

  • 分析 patch、PR 差異，整理合併注意事項。

  • 協助撰寫 changelog 或版本發布備忘。

---

5. 🔍 Ask Mode（一般提問模式）

• 用途：快速提問非程式導向的問題。

• 特性：

  • 開放型模式，不依賴開發上下文。

  • 適合提問：語法、概念、函式行為、命名建議等。

• 常見使用情境：

  • 詢問某 TypeScript 語法用途。

  • 調查 AdonisJS 中某 decorator 的功能。

  • 對比 ORM 中 .preload() 與 .with() 差異。