Cursor 快速入門02:Cursor Rules 專業用法

Cursor Rules 提供了一種「持續、可重複、範圍限定」的方式，將專案或使用者層級的指引編碼到模型上下文中

讓 AI Agent 在執行時，能一貫地遵守同一套規範。

什麼是 Cursor Rules？

Cursor Rules 分為兩大類：

1. User Rules：在 Cursor 設定裡定義，對所有專案全域生效，只能以純文字撰寫。
2. Project Rules：使用 MDC 格式，針對特定專案範圍生效。

User Rules 使用指南

基礎應用

最簡單的 User Rule 示例：

Always respond in 中文

在user rule 貼上"Always respond in 中文" 這樣設定後，Cursor 就會始終用中文回答。

進階應用

以下是一個更完整的 User Rule 示例，包含任務完成後的總結格式：

After All completed task, summarize the work in Chinese with the following format:
What was changed?, What was done? Key points?

when generating commit message, follow conventional commit and start with a category such as feat:, chore:, or fix:, and then only give one line commit message
All other execution, comments, or code should be in English.

💡 最佳實踐：User Rules 最好只寫自己的習慣和期望的回答方式，像積木一樣可以組裝，這樣才會靈活。規範和 coding style 這些最好寫在 Project Rules 中。

Project Rules 詳解

新增方法

有兩種方式可以新增 Project Rules：

1. 在設定中點擊 "Add new rule"
2. 在 Chat 視窗中使用 /Generate Cursor Rules 命令，根據對話內容自動生成 MDC 規則檔

規則類型說明

Cursor 提供四種規則類型：

1. Always：一律都會被包含在上下文
2. Auto Attached：當模型操作到匹配規則的檔案時，自動附加到上下文
3. Agent Requested：AI Agent 根據內部判斷決定是否要載入
4. Manual：必須在對話或指令中顯式呼叫 @ruleName 才會載入

   💡 可以簡單理解為4種選擇1.永遠2.規則匹配 3.ai 自己判斷4.只有手動貼上才生效

如何寫好 Cursor Rules

規則撰寫原則

官方建議

• 保持規則簡潔，建議不超過 500 行
• 將大型概念拆分成多個可組合的規則
• 提供具體示例或參考檔案
• 避免模糊的指導，寫規則的方式應該像寫清晰的內部文件
• 當發現在聊天中重複提示時，考慮重用規則

💡 關鍵原則：就像程式設計一樣，遵循「低耦合高內聚」的原則。把規則想像成積木，每個規則專注於一個功能，不超過 500 行，內容要清晰且最好附帶示例。

規則範本參考

推薦使用 awesome-cursorules 作為參考，根據你使用的程式語言或框架選擇合適的範本。建議對範本進行「減法」，去除不必要的內容，確保符合上述原則。

臨時規則生成

當遇到特定 AI 行為需要調整時，可以使用 /Generate Cursor Rules 命令直接生成規則。例如，當前端專案使用 yarn 但 Cursor 卻使用 npm 時，可以立即生成一個規則來糾正這個行為。

總結

• Cursor Rules 分為 User Rules（個人設定）和 Project Rules（專案需求）
• 規則應該像積木一樣模組化，內容精簡清晰
• 可以參考 awesome-cursorules 或與 Cursor AI 討論來生成規則
• 規則撰寫要遵循簡潔、明確、可重用的原則

相關資源

• Cursor 官方文件 - Rules
• awesome-cursorules GitHub 倉庫