Cursor – 規則

規則會為 Agent 與 Inline Edit 提供系統層級的指示。把它們想成是你專案的持久化上下文、偏好或工作流程。 Cursor 支援四種規則：

Project Rules

儲存在 .cursor/rules，受版本控制，且限定於你的程式碼庫。

User Rules

作用於整個 Cursor 環境。在設定中定義，並且會一律套用。

AGENTS.md

以 Markdown 格式撰寫的 Agent 指示，是 .cursor/rules 的簡易替代方案。

.cursorrules (Legacy)

仍支援，但已淘汰。請改用 Project Rules。

規則如何運作

大型語言模型不會在每次完成之間保留記憶。規則能在提示層級提供持久、可重複使用的上下文。套用後，規則內容會被加入在模型上下文的開頭。這能為 AI 在產生程式碼、理解編輯或協助工作流程時提供一致的指引。

規則適用於 Chat 和 Inline Edit。啟用的規則會顯示在 Agent 側邊欄。

專案規則

專案規則存放於 .cursor/rules。每條規則都是獨立檔案並受版本控制。可用路徑模式限定作用範圍、手動呼叫，或依相關性自動包含。子目錄可包含自己的 .cursor/rules 資料夾，作用範圍僅限該資料夾。使用專案規則來：

編碼與你程式碼庫相關的領域知識
自動化專案專屬的工作流程或範本
標準化風格或架構決策

規則結構

每個規則檔以 MDC（.mdc）撰寫，這是一種同時支援中繼資料與內容的格式。可從類型下拉選單控制規則的套用方式，會變更 description、globs、alwaysApply 屬性。

Rule Type	Description
`Always`	一律包含在模型脈絡中
`Auto Attached`	當參照到符合 glob 模式的檔案時自動包含
`Agent Requested`	提供給 AI，由它決定是否包含。必須提供描述
`Manual`	只有在明確以 `@ruleName` 提及時才會包含

---
description: RPC Service boilerplate
globs:
alwaysApply: false
---

- Use our internal RPC pattern when defining services
- Always use snake_case for service names.

@service-template.ts

巢狀規則

在專案各處的 .cursor/rules 資料夾中放置規則以組織管理。當參照到其目錄內的檔案時，巢狀規則會自動附加。

project/
  .cursor/rules/        # 專案層級規則
  backend/
    server/
      .cursor/rules/    # Backend 專用規則
  frontend/
    .cursor/rules/      # Frontend 專用規則

建立規則

使用 New Cursor Rule 指令或前往 Cursor Settings > Rules 建立規則。這會在 .cursor/rules 建立新的規則檔。在設定中你可以看到所有規則及其狀態。

產生規則

在對話中直接使用 /Generate Cursor Rules 指令產生規則。當你已經對 agent 行為做出決策並想重複使用時很實用。

最佳實務

好的規則應該專注、可執行，且範圍清晰。

讓規則保持在 500 行以內
把大型規則拆成多個可組合的規則
提供具體範例或參考檔案
避免模糊的指引。把規則寫成清晰的內部文件
在聊天中重複提示時重用規則

範例

前端元件與 API 驗證標準

Express 服務與 React 元件範本

自動化開發流程與文件產生

在 Cursor 中新增設定

先在 @reactiveStorageTypes.ts 建立要切換的屬性。在 @reactiveStorageService.tsx 的 INIT_APPLICATION_USER_PERSISTENT_STORAGE 中加入預設值。若是 beta 功能，在 @settingsBetaTab.tsx 加入切換；否則在 @settingsGeneralTab.tsx 加入。一般核取方塊可用 <SettingsSubSection> 新增。參考該檔其餘部分的範例。

<SettingsSubSection
				label="Your feature name"
				description="Your feature description"
				value={
					vsContext.reactiveStorageService.applicationUserPersistentStorage
						.myNewProperty ?? false
				}
				onChange={(newVal) => {
					vsContext.reactiveStorageService.setApplicationUserPersistentStorage(
						'myNewProperty',
						newVal
					);
				}}
			/>

在 App 中使用時，匯入 reactiveStorageService 並讀取該屬性：

const flagIsEnabled = vsContext.reactiveStorageService.applicationUserPersistentStorage.myNewProperty

有許多來自供應商與框架的範例。社群貢獻的規則可在眾包的集合與線上儲存庫中找到。

AGENTS.md

AGENTS.md 是一個用來定義代理指令的簡單 Markdown 檔案。把它放在專案根目錄，作為 .cursor/rules 的替代方案，適用於簡單明瞭的使用情境。與 Project Rules 不同，AGENTS.md 是沒有中介資料或複雜設定的純 Markdown 檔。非常適合需要簡單、易讀指令、又不想負擔結構化規則成本的專案。

# Project Instructions

## Code Style
- Use TypeScript for all new files
- Prefer functional components in React
- Use snake_case for database columns

## Architecture
- Follow the repository pattern
- Keep business logic in service layers

目前的限制

只支援根目錄：AGENTS.md 必須放在專案根目錄（v1.5）
無範圍設定：指令會全域套用到你的專案
單一檔案：不同於 .cursor/rules，你不能把指令拆分到多個檔案

在子目錄中的巢狀 AGENTS.md 支援預計於 v1.6 推出。

使用者規則

使用者規則是定義在 Cursor Settings → Rules 的全域偏好設定，會套用到所有專案。它們是純文字，很適合用來設定偏好的溝通風格或程式碼慣例：

Please reply in a concise style. Avoid unnecessary repetition or filler language.

`.cursorrules`（舊版）

專案根目錄中的 .cursorrules 檔案仍受支援，但即將淘汰。建議改用 Project Rules，以取得更高的控制度、彈性與可觀察性。

常見問題

為什麼我的規則沒有生效？

規則可以參照其他規則或檔案嗎？

我可以在聊天中建立規則嗎？

規則會影響 Cursor Tab 或其他 AI 功能嗎？

開始使用

核心

內容脈絡

整合

模型

設定

帳戶

疑難排解

規則

Project Rules

User Rules

AGENTS.md

.cursorrules (Legacy)

規則如何運作

專案規則

規則結構

巢狀規則

建立規則

產生規則

最佳實務

範例

AGENTS.md

目前的限制

使用者規則

`.cursorrules`（舊版）

常見問題

開始使用

核心

內容脈絡

整合

模型

設定

帳戶

疑難排解

Project Rules

User Rules

AGENTS.md

.cursorrules (Legacy)

​規則如何運作

​專案規則

​規則結構

​巢狀規則

​建立規則

​產生規則

​最佳實務

​範例

​AGENTS.md

​目前的限制

​使用者規則

​.cursorrules（舊版）

​常見問題

規則如何運作

專案規則

規則結構

巢狀規則

建立規則

產生規則

最佳實務

範例

AGENTS.md

目前的限制

使用者規則

`.cursorrules`（舊版）

常見問題