Cline Rules (.clinerules/): vị trí và cách các tool đọc tệp

Cline Rules là các tệp Markdown trong .clinerules/ mà Cline kết hợp với rule toàn cục và AGENTS.md. Frontmatter paths không bắt buộc có thể giới hạn một rule chỉ áp dụng cho các tệp khớp.

Vị trí

• Workspace: .clinerules/*.md hoặc .cline/rules/*.md; cả hai vị trí đều được tìm kiếm.
• Toàn cục: Documents\Cline\Rules trên Windows, ~/Documents/Cline/Rules trên macOS và Linux, cùng với ~/.cline/rules và ~/Cline/Rules.
• Các tệp dùng chung giữa nhiều công cụ được tự động phát hiện: AGENTS.md, ~/.agents/AGENTS.md, .cursorrules và .windsurfrules.

Định dạng

Tệp Markdown, có thể đánh số như 01-coding.md và có thể có YAML frontmatter. Mảng paths chứa các glob sẽ kích hoạt quy tắc khi có bất kỳ mẫu nào khớp với tệp trong ngữ cảnh. Không có frontmatter nghĩa là quy tắc luôn hoạt động; paths: [] nghĩa là quy tắc không bao giờ hoạt động; YAML không hợp lệ thì quy tắc vẫn được áp dụng.

Các khóa frontmatter: paths

---
paths:
  - "src/components/**"
  - "src/hooks/**"
---

# Components and hooks

- Function components only.
- Hook names start with use and the files live in src/hooks/.
- Split any component that grows past 200 lines.
- Add a test next to each new hook.

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

Các quy tắc ở workspace và cấp toàn cục được kết hợp; khi có xung đột, quy tắc ở workspace được ưu tiên. Có thể bật hoặc tắt riêng từng quy tắc.

Mẹo

• Trong ngữ cảnh nghĩa là các đường dẫn được đề cập, tab đang mở hoặc hiển thị, tệp đã chỉnh sửa và các chỉnh sửa đang chờ áp dụng.
• Vì YAML không hợp lệ vẫn khiến quy tắc được áp dụng, lỗi chính tả trong paths sẽ làm quy tắc luôn hoạt động; hãy kiểm tra lại sau khi chỉnh sửa.
• Tạo quy tắc trong bảng Rules của VS Code hoặc bằng lệnh slash /newrule.

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