工作流程

// 步驟 1：了解整體架構
"@codebase 這個專案的整體架構是什麼？
有哪些主要模組？它們如何互動？"

// 步驟 2：了解關鍵流程
"從用戶登入到取得資料，整個流程經過哪些檔案？"

// 步驟 3：理解特定功能
"@src/auth/middleware.ts 這個中間件做了什麼？
為什麼要在這裡驗證 JWT？"

// 步驟 4：找出依賴關係
"@src/services/userService.ts 這個服務依賴了哪些其他模組？
如果我要修改資料庫 schema，哪些地方需要更新？"

// 選取複雜的程式碼區塊，在 Chat 中問：
"這段程式碼在做什麼？有什麼潛在問題嗎？"

// 理解設計決策
"為什麼這裡用 setTimeout 而不是 Promise？
這個設計有什麼考量？"

// 了解副作用
"如果我修改這個函式的回傳型別，
哪些地方會受到影響？"

// 先用 Chat 規劃，不要急著讓 Agent 開始修改
"我需要加入用戶通知功能：
- 用戶可以設定通知偏好（Email/SMS/推播）
- 系統事件觸發時發送對應通知
- 通知有已讀/未讀狀態

請幫我規劃這個功能需要：
1. 修改哪些資料庫 schema
2. 需要新增哪些 API 端點
3. 前端需要哪些新元件
4. 有哪些邊界情況需要處理"

// 確認計畫後，切換到 Agent 模式執行
"根據我們剛才規劃的通知功能：
1. 先建立資料庫 schema（使用 Drizzle ORM）
2. 建立 NotificationService 類別
3. 為現有的 UserService 加入通知觸發點

請從 schema 開始，完成後告訴我再繼續下一步"

// 步驟 1：描述問題現象
"用戶點擊購買按鈕後，頁面沒有反應。
Console 顯示：
TypeError: Cannot read property 'id' of undefined
  at CartService.checkout (cartService.ts:45)

@cartService.ts 幫我找出這個問題的根源"

// 步驟 2：理解錯誤脈絡
"這個錯誤在什麼情況下會發生？
什麼時候 user 會是 undefined？"

// 步驟 3：讓 Agent 修復
"找到問題了：用戶未登入時呼叫了需要 userId 的 API。
請修復這個問題，加入適當的守衛條件，
未登入時引導用戶至登入頁面"

// 直接引用 Terminal 的錯誤訊息
@errors 這個編譯錯誤是什麼意思？如何修復？

// 引用 Console 錯誤
"剛才執行 npm test 出現以下錯誤，
幫我找出原因並修復：
[貼上錯誤訊息]"

// 請 AI 審查你的變更
"@git diff HEAD~1 審查這次的程式碼變更：
1. 有沒有潛在的 bug？
2. 有沒有違反我們的程式碼規範？
3. 有沒有遺漏的邊界情況？
4. 效能有沒有問題？"

// 生成 PR 描述
"根據這次的變更，幫我撰寫一份清楚的 PR 描述，
包含：變更內容摘要、影響範圍、測試方式"

// 預想 Reviewer 的問題
"如果你是 Code Reviewer，
你會對這段程式碼提出什麼問題？"

// 在 .gitignore 中確保 .cursorrules 不被排除
// （預設 .cursorrules 不在 .gitignore 中）

// 在 README 中說明 .cursorrules 的用途：
## AI 輔助開發規範
本專案包含 .cursorrules 設定檔，
使用 Cursor AI 時請確保已開啟此功能。
設定內容包含：
- 程式碼風格規範
- 技術棧偏好
- 命名慣例