Phần 8 của 5160% hoàn thành

Rules — hướng dẫn AI theo dự án và cá nhân

English title: Rules — Guide AI by Project and Personal Conventions

Bài 8 trong chuỗi 15 bài hướng dẫn Cursor. "Luôn follow những quy tắc này" — không cần nhắc mỗi lần. Rules trong Cursor là hướng dẫn (instructions) được đưa vào context mặc định: AI đọc và áp dụng khi trả lời hoặc khi thực hiện task. Có Project rules (theo repo, trong .cursor/rules), User rules (global, chỉ máy bạn), Team rules (dashboard, cả team), và AGENTS.md (file markdown đơn giản ở root). Bài này hướng dẫn cách dùng và ví dụ rules hữu ích.

Mở đầu: Không cần nhắc mỗi lần

Bạn không muốn mỗi lần chat đều phải gõ "nhớ dùng TypeScript strict", "không commit API key", "trả lời bằng tiếng Việt khi tôi hỏi tiếng Việt". Rules giúp bạn khai báo một lần; Cursor inject rules vào đầu context của mỗi session (hoặc mỗi request), AI mặc định follow. Bạn có thể tạo rule qua Settings hoặc gõ /create-rule trong chat để lưu từ cuộc hội thoại hiện tại.

1. Đi sâu: Rules là gì

Tại sao chủ đề này quan trọng: Thiếu rules thì mỗi lần bạn phải nhắc convention; khi làm team thì mỗi người nhắc một kiểu, AI trả lời không nhất quán. Rules = single source of truth cho "AI phải follow gì".

Hiểu sai thường gặp: Nhiều người nghĩ "rules = chỉ coding style". Thực tế rules có thể bao gồm: ngôn ngữ (TypeScript, Python), style (format, naming), bảo mật (không commit secret), workflow (chạy test trước khi suggest commit), và cả preference cá nhân (trả lời bằng tiếng Việt khi user viết tiếng Việt).

Bản chất đúng: Rules = đoạn text (markdown hoặc plain text) chứa hướng dẫn; Cursor đưa rules vào system/context khi gọi model. Project rules = lưu trong repo (vd. .cursor/rules/), version control, mọi người mở project đều dùng. User rules = lưu global (chỉ máy bạn). Team rules = quản lý qua Cursor for Teams/Enterprise. AGENTS.md = file ở root repo, Cursor có thể đọc như rule đơn giản (theo docs).

2. Khái niệm

Project rules: Nằm trong project (vd. .cursor/rules/); có thể nhiều file. Commit vào git để team dùng chung.
User rules: Trong Settings Cursor, áp dụng cho mọi project trên máy bạn.
Team rules: Trong dashboard Cursor (Team/Enterprise); áp dụng cho cả team.
AGENTS.md: File markdown ở root project; nội dung mô tả hướng dẫn cho agent. Một số bản Cursor đọc file này làm rule.
/create-rule: Slash command trong Chat/Composer — tạo rule mới từ nội dung hoặc thỏa thuận trong cuộc hội thoại hiện tại; có thể lưu vào Project hoặc User.

3. Workflow: Tạo và chỉnh Rules

Xác định quy ước quan trọng — Ví dụ: "Luôn dùng TypeScript strict"; "Không commit file chứa API key"; "Khi user viết tiếng Việt thì trả lời tiếng Việt có dấu."
Chọn scope — Chung cho project → Project rules (.cursor/rules/ hoặc tạo qua Settings). Chỉ cho mình → User rules.
Viết rule ngắn gọn — Tránh dài dòng; ưu tiên bullet hoặc câu ngắn. Rule quá dài tốn token và đôi khi model "quên" giữa chừng.
/create-rule — Nếu vừa thỏa thuận với AI một quy tắc (vd. "luôn chạy test trước khi suggest commit"), gõ /create-rule để lưu thành rule; chỉnh lại cho gọn nếu cần.

4. Ví dụ rules hữu ích

Coding: "Use TypeScript strict mode. Prefer named exports. No any."
Security: "Never suggest committing API keys, tokens, or secrets. Remind user to use env variables."
Workflow: "Before suggesting a commit, run tests and lint. If tests fail, suggest fixes first."
Language: "When the user writes in Vietnamese, respond in Vietnamese with proper diacritics. Keep technical terms in English (e.g. Composer, Agent, Plan mode)."
Naming: "Use camelCase for variables and functions; PascalCase for components and types."

5. Ứng dụng

Sau bài này bạn đã biết: Rules = hướng dẫn luôn được áp dụng; Project / User / Team và AGENTS.md; /create-rule để lưu nhanh. Bài tiếp: MCP — kết nối Cursor với DB, API, GitHub qua Model Context Protocol.

Bài tiếp: MCP — kết nối tool và dữ liệu ngoài (bài 9).