Cursor Project Rules (.cursor/rules/*.mdc): vị trí và cách các tool đọc tệp

Project Rules của Cursor là các tệp .mdc trong .cursor/rules/; frontmatter của mỗi tệp quyết định thời điểm áp dụng quy tắc. Cursor cũng đọc AGENTS.md, cùng với User Rules và Team Rules được thiết lập bên ngoài repository.

Vị trí

• .cursor/rules/**/*.mdc; có thể dùng thư mục con. Các tệp .md thuần trong .cursor/rules sẽ bị bỏ qua.
• AGENTS.md ở thư mục gốc và trong các thư mục lồng nhau.
• User Rules, được thiết lập trong cài đặt Cursor.
• Team Rules, được thiết lập trong bảng điều khiển nhóm.

Định dạng

Markdown có YAML frontmatter và bắt buộc dùng phần mở rộng .mdc. alwaysApply: true luôn áp dụng quy tắc; globs cùng alwaysApply: false sẽ áp dụng quy tắc khi có tệp khớp nằm trong context; nếu chỉ có description, Agent sẽ tự quyết định. Nếu không có các trường này, quy tắc chỉ áp dụng khi bạn @-mention nó.

Các khóa frontmatter: descriptionglobsalwaysApply

---
description: React component conventions
globs: src/components/**/*.tsx
alwaysApply: false
---

- One component per file, with a named export matching the file name.
- Type props with an interface named after the component plus Props.
- Use the existing CSS modules; no inline style objects.
- Follow @src/components/Button.tsx as the reference pattern.

Thứ tự ưu tiên và hợp nhất

Team Rules, rồi Project Rules, sau đó User Rules. Các quy tắc áp dụng được sẽ hợp nhất; khi có xung đột, nguồn đứng trước sẽ được ưu tiên. Không thể tắt Team Rules bắt buộc. Các tệp AGENTS.md lồng nhau được kết hợp với tệp ở thư mục cha; tệp cụ thể hơn sẽ được ưu tiên.

Các tool đọc tệp này

Mẹo

• Phân tách nhiều glob bằng dấu phẩy trong trường globs.
• Giữ mỗi rule dưới 500 dòng và tham chiếu đến tệp bằng @filename thay vì sao chép nội dung vào.
• Rules không ảnh hưởng đến Cursor Tab, còn User Rules không áp dụng cho Inline Edit.
• Tệp .cursorrules cũ không còn được nhắc đến trong tài liệu của Cursor; hãy chuyển tệp này vào .cursor/rules/.

Các tệp hướng dẫn khác