---
title: "Devin Desktop (Windsurf) rules: đường dẫn và định dạng · DotsAgent"
description: "Vị trí của .devin/rules/*.md, định dạng và frontmatter, cách hợp nhất các bản sao toàn cục và lồng nhau, cùng các tool đọc tệp này. Đã kiểm tra ngày 2026-10-01."
url: https://dotsagent.io/vi/instructions/files/windsurf-rules
---

.devin/rules/*.md

# Devin Desktop (Windsurf) rules: vị trí và cách các tool đọc tệp

Devin Desktop, tên mới của Windsurf kể từ 2026-06-02, đọc các tệp rule trong .devin/rules/ và vẫn hỗ trợ .windsurf/rules/ cùng tệp .windsurfrules cũ. Trigger của mỗi rule quyết định rule luôn được áp dụng, được kích hoạt khi khớp glob, do model chọn hay được gọi thủ công.

## Vị trí

- Workspace: .devin/rules/*.md (ưu tiên) hoặc .windsurf/rules/*.md (dự phòng).
- Tệp đơn cũ: .windsurfrules ở thư mục gốc của workspace; tệp này vẫn được đọc.
- Toàn cục: ~/.codeium/windsurf/memories/global_rules.md, luôn được áp dụng.
- AGENTS.md trong bất kỳ thư mục nào.
- Hệ thống (Enterprise): /Library/Application Support/Devin/rules/*.md, /etc/devin/rules/*.md hoặc C:\ProgramData\Devin\rules\*.md.

## Định dạng

Markdown; các rule trong workspace bắt đầu bằng YAML frontmatter. trigger là always_on, model_decision, glob hoặc manual; rule glob cần có globs, còn model_decision cần có description. global_rules.md giới hạn ở 6,000 ký tự và mỗi tệp rule trong workspace giới hạn ở 12,000 ký tự.

Các khóa frontmatter: `trigger``globs``description`

`.devin/rules/*.md`

```
---
trigger: glob
globs: **/*.test.ts
---

# Test files

- Use Vitest and import describe, it and expect explicitly.
- Test one behaviour per case and name it in plain English.
- Mock network calls with the helpers in test/mocks/.
- Never call real payment APIs from a test.
```

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

.devin/ được ưu tiên hơn .windsurf/. Rule hệ thống được kết hợp với rule trong workspace và rule toàn cục, không ghi đè chúng; global_rules.md và AGENTS.md ở thư mục gốc luôn được áp dụng. Rule được tìm trong workspace, các thư mục con và thư mục cha cho đến git root.

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

| Công cụ | Hỗ trợ |
| --- | --- |
| [Cline](https://docs.cline.bot/features/cline-rules) | Phát hiện tệp .windsurfrules cũ. |

## Mẹo

- Tạo rule mới trong .devin/rules/; chỉ giữ .windsurf/rules/ để tương thích với các bản cài đặt cũ.
- Dùng trigger: model_decision với description rõ ràng cho những hướng dẫn mà agent chỉ nên đưa vào khi phù hợp.
- Memories được tạo tự động chỉ áp dụng cho agent Cascade cũ, không áp dụng cho Devin Local, hiện là mặc định.

Tạo AGENTS.md và các tệp rule tương ứng cho năm tool từ một biểu mẫu. [Mở trình tạo AGENTS.md →](https://dotsagent.io/vi/instructions)

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

[AGENTS.md](https://dotsagent.io/vi/instructions/files/agents-md)

[CLAUDE.md](https://dotsagent.io/vi/instructions/files/claude-md)

[GEMINI.md](https://dotsagent.io/vi/instructions/files/gemini-md)

[.cursor/rules/*.mdc](https://dotsagent.io/vi/instructions/files/cursor-rules)

[.github/copilot-instructions.md](https://dotsagent.io/vi/instructions/files/github-copilot-instructions)

[.clinerules/](https://dotsagent.io/vi/instructions/files/cline-rules)

[~/.openclaw/workspace/AGENTS.md](https://dotsagent.io/vi/instructions/files/openclaw-workspace)

## Nguồn

1. [docs.windsurf.com](https://docs.windsurf.com/windsurf/cascade/memories)/windsurf/cascade/memories
2. [devin.ai](https://devin.ai/blog/windsurf-is-now-devin-desktop)/blog/windsurf-is-now-devin-desktop
3. [docs.devin.ai](https://docs.devin.ai/desktop/devin-desktop-faq)/desktop/devin-desktop-faq

Tài liệu tham khảo độc lập dành cho những người xây dựng AI agent. Không liên kết với bất kỳ nhà cung cấp nào được nêu ở đây.

© 2026 DotsAgent · Dữ liệu được kiểm tra ngày 1 tháng 10, 2026