Rules
Rules 是給 agent 的靜態說明：專案慣例、目錄結構、不能做的事。放在 .cursor/rules/，通常是帶 front matter 的 .mdc 檔，可進版本控制，讓每個 clone 下來的人都一樣。
把它想成 onboarding 文件，不要想成「寫一篇高級工程師人設」。空泛的「寫乾淨的程式」幾乎不會改變行為；「API 路由放在 app/api/[resource]/route.ts，測試對應 src/__tests__/」才會。
四種掛載方式
| 類型 | 何時載入 | 適合 |
|---|---|---|
| Always | 每次對話 | 極短、全專案都適用的硬性約束 |
| Auto Attached | 上下文出現符合 glob 的檔 | 前端／後端分開的風格 |
| Agent Requested | agent 依 description 自行判斷 | 偶爾才用的規範 |
| Manual | 你在對話用 @規則名 |
很少用、但要用時要完整 |
實務建議：Always 保持很短。大部分規則用 glob 自動掛上。官方建議單檔不要太長；能改行為的指示通常遠小於 100 行。
根目錄也可以放 AGENTS.md（純 Markdown、沒有 front matter）。不要跟舊的單檔 .cursorrules 混用兩套，行為不好預測。個人偏好可寫在 Cursor 設定的 user rules，不要把「我喜歡的註解風格」寫進團隊 repo。
規則裡不要寫什麼
- 模型已經會的空話（「小心一點」「當資深工程師」）
- 會過期的捷徑名稱、過時套件版本（除非你真的鎖死了）
- 整本風格指南的複製貼上；改成「看
CONTRIBUTING.md的測試一節」並用 glob 掛上
寫完用一個真實小任務試：如果它還是踩同一條雷，把那條雷寫成可檢查的句子（含路徑或指令），而不是再加形容詞。
推薦影音
繁中實作：林鼎淵（工程師下班有約）示範範圍限制與 Rules 如何讓答案比較不像通用範本。介面可能略舊，對照本頁觀念即可。