Cách viết quy tắc chung trên Cursor

Cursor Rules là một trong những tính năng mạnh mẽ nhất của Cursor IDE năm 2026. Đây là hệ thống hướng dẫn bền vững (persistent instructions) giúp AI hiểu rõ phong cách coding, quy ước dự án, best practices và yêu cầu cụ thể mà bạn đưa ra.

Thay vì phải lặp lại yêu cầu trong mọi prompt, bạn chỉ cần viết rules một lần – Cursor sẽ tự động áp dụng chúng vào Chat, Composer, Agent Mode và Inline Edit.

Rules hiện sử dụng định dạng .mdc (Markdown với frontmatter YAML) và được lưu chủ yếu trong thư mục .cursor/rules/ . File .cursorrules cũ vẫn hỗ trợ nhưng không còn là cách khuyến nghị. Nếu bạn chỉ muốn tạo rules riêng cho từng dự án trong Cursor, hãy xem tại: Hướng dẫn thiết lập quy tắc trên Cursor.

Các bước hướng dẫn tạo Rules chung trên Cursor

Bước 1: Mở Cursor IDE

Khởi động Cursor trên máy tính (Windows, macOS hoặc Linux). Nhấn Cmd + , (Mac) hoặc Ctrl + , (Windows/Linux), hoặc đi đến menu File (1) → Preferences (2) → Cursor Settings (3). Hoặc là bạn cũng có thể dùng Command Palette (Cmd + Shift + P) và gõ “Cursor Settings”.

Bước 2: Truy cập tab Rules và tạo Rule mới

Trong cửa sổ Settings, tìm và chọn Rules, Commands (hoặc Rules, Skills, Subagents tùy giao diện) - (1). Đây là nơi quản lý tất cả User Rules, Project Rules và Team Rules. Chọn loại: All (áp dụng cho mọi project) hoặc User (chỉ áp dụng cho project hiện tại). Cursor sẽ tự động tạo file .mdc trong thư mục .cursor/rules/.

Nhập Name (tên rule) và Description rõ ràng. Description giúp AI hiểu khi nào nên áp dụng rule này.

Viết nội dung rule Sử dụng định dạng .mdc với phần frontmatter YAML ở đầu file, sau đó là nội dung hướng dẫn bằng Markdown. Lưu file và Cursor sẽ tự động load rule.

Sau khi đã hoàn thành nội dung trong phần Rules, hãy chọn Done để lưu lại.

Chọn Delete nếu muốn hủy Rules đã tạo, ngoài ra bạn cũng có thể thêm Rules mới bằng cách chọn New.

Bước 4: Kiểm tra và áp dụng

Mở Composer hoặc Chat, chạy một prompt đơn giản để kiểm tra xem rule có được áp dụng không. Bạn có thể xem danh sách rules đang active trong Settings.

Cấu trúc file .mdc chuẩn 2026

Một file .mdc cơ bản có dạng sau:

---
description: Quy tắc coding cho dự án Next.js App Router
globs: ["**/*.tsx", "**/*.ts"]
alwaysApply: true
---

# Hướng dẫn cho AI

- Luôn sử dụng TypeScript strict mode.
- Component phải là functional component với React 19.
- Sử dụng Tailwind CSS cho styling...

• description: Mô tả ngắn gọn mục đích rule.
• globs: Áp dụng rule chỉ cho một số loại file (ví dụ: chỉ file .tsx ).
• alwaysApply: true để rule luôn được load.

Mẹo viết Cursor Rules hiệu quả

• Càng cụ thể càng tốt: Đừng viết chung chung. Hãy đưa ví dụ code trước và sau.
• Sử dụng ví dụ: AI học rất tốt từ ví dụ thực tế (before/after).
• Giữ rule ngắn gọn: Một rule nên tập trung vào một chủ đề (naming, component structure, API handling…).
• Kết hợp nhiều file .mdc: Thay vì một file khổng lồ, hãy tách thành nhiều file nhỏ trong thư mục .cursor/rules/.

Một số ví dụ Cursor Rules thường gặp

1. Rule về Naming Convention

---
description: Enforce consistent naming for React components and files
alwaysApply: true
---

- Component names phải dùng PascalCase.
- File component phải khớp tên: `UserProfile.tsx` chứa component `UserProfile`.
- Biến, hàm dùng camelCase.
- Constants dùng UPPER_SNAKE_CASE.

2. Rule cho Next.js Project

---
description: Next.js 15 App Router best practices
globs: ["**/*.{ts,tsx}"]
---

- Luôn dùng Server Components mặc định.
- Client Components chỉ khi cần useState, useEffect.
- Sử dụng async/await cho data fetching.
- Không dùng <a> tag, thay bằng <Link> từ next/link.

3. Rule về Error Handling

---
description: Consistent error handling pattern
---

Khi xử lý lỗi:
- Sử dụng try/catch.
- Log lỗi với console.error và gửi report nếu production.
- Trả về thông báo thân thiện cho user.
Ví dụ:
```ts
try {
  // code
} catch (error) {
  console.error("Failed to fetch data:", error);
  // handle UI error
}

Lợi ích khi sử dụng Cursor Rules tốt

Với rules được viết tốt, Cursor Composer và Agent Mode sẽ:

• Tự động tuân thủ phong cách code của bạn.
• Giảm lỗi lặp lại (inconsistent naming, wrong import…).
• Tăng tốc độ phát triển đáng kể.
• Giúp team làm việc đồng bộ hơn (dùng Project Rules hoặc Team Rules).

Nhiều developer báo cáo năng suất tăng 2-4 lần khi có bộ rules cá nhân hóa.

Cách quản lý và tối ưu Rules năm 2026

• User Rules: Áp dụng toàn cầu (coding style cá nhân).
• Project Rules: Dành riêng cho từng dự án (framework, architecture).
• Sử dụng lệnh /create-rule trong Chat hoặc Agent để Cursor tự sinh rule theo mô tả.
• Thường xuyên review và cập nhật rules khi project thay đổi.
• Kết hợp với .cursorrules cũ nếu bạn đang migrate.

Cursor Rules chính là “system prompt” cá nhân hóa cho AI coding assistant. Khi viết rules rõ ràng, cụ thể và có ví dụ, bạn đang biến Cursor thành một lập trình viên đồng nghiệp thực thụ – luôn hiểu ý bạn và viết code đúng chuẩn.