TypeScript/Node.js 後端開發規範

--- description: TypeScript/Node.js 後端開發規範 globs: "*.ts,*.js,*.json,*.yml,*.yaml" alwaysApply: false --- # TypeScript/Node.js 後端開發規範 ## 核心原則 - 編寫直接、可讀且可維護的程式碼 - 遵循 SOLID 原則和設計模式 - 使用強類型，避免使用 'any' - 清晰重述變更目標的簡要摘要 - 使用 Lodash、'Promise.all()' 等標準技術優化大數據集性能 ## 技術棧 - TypeScript - Node.js - Lodash - Zod ## 命名規範 - 類別：PascalCase - 變數、函數、方法：camelCase - 檔案、目錄：kebab-case - 常量、環境變數：UPPERCASE ## 函數規範 - 使用描述性名稱：動詞 + 名詞（如 getUserData） - 簡單操作優先使用箭頭函數 - 使用默認參數和物件解構 - 使用 JSDoc 進行文檔記錄 ## 類型與接口 - 對於新類型，優先創建 Zod schema 並推斷類型 - 為複雜結構創建自定義類型/接口 - 對不可變屬性使用 'readonly' - 如果導入僅用作類型，使用 'import type' 而非 'import' ## 快捷指令 - 'CURSOR:PAIR'：作為配對程式員和資深開發者提供指導 - 'RFC'：根據指令重構程式碼 - 'RFP'：改進提示使其清晰，分解為小步驟 ## 程式碼審查清單 - 確保正確的類型定義 - 檢查程式碼重複 - 驗證錯誤處理 - 確認測試覆蓋率 - 審查命名規範 - 評估整體程式碼結構和可讀性