surfup

Cursor 和 Claude Code 的 12 條專案規則

12 條實用規則,涵蓋程式碼儲存庫背景、SEO、安全性與可驗證的變更。

請將以下規則作為工作檢查清單,並依據專案的證據、範圍與限制調整。

背景與範圍

  • 閱讀適用於此工具的專案指示(若有,例如 .cursor/rules 或 CLAUDE.md);也要檢查 README 和 manifest(若有)。
  • 編輯前先概述目前的架構,並只列出這項變更需要涉及的檔案。
  • 將目標定義為一項可驗證的成果;沒有理由時不要擴大任務範圍。
  • 變更 API 前,先確認其使用者、請求/回應格式及相容性需求。

品質與安全

  • 針對每一項使用者輸入,明確定義格式、長度和不安全值的驗證方式。
  • 絕不要將機密放入程式碼、記錄檔、測試資料、範例或隨前端發布的資產中。
  • 針對搜尋頁面,檢查 title、description、canonical、robots、標題、連結和原始 HTML。
  • 各語系應使用自己的文案、符合當地習慣的聯絡範例,以及彼此對應的網址。
  • 確保互動元素可用鍵盤操作、具有輔助科技可辨識的名稱,且焦點狀態清楚可見。

驗證與回報

  • 只執行能驗證本次變更行為的檢查;不要聲稱執行過實際上未執行的指令。
  • 對照驗收條件檢查結果,並查看錯誤路徑和行動裝置版面。
  • 回報變更內容、實際執行的指令及結果、已知限制和復原方式。