Devin Desktop (Windsurf) rules：存放位置及工具读取方式

自 2026-06-02 起，Windsurf 更名为 Devin Desktop。它会从 .devin/rules/ 读取规则文件，同时仍支持 .windsurf/rules/ 和旧版 .windsurfrules。每条规则是否生效取决于其触发方式：始终生效、按 glob 匹配、由模型选择或手动调用。

存放位置

• 工作区：.devin/rules/*.md（首选）或 .windsurf/rules/*.md（备用）。
• 旧版单文件：工作区根目录下的 .windsurfrules，仍会读取。
• 全局：~/.codeium/windsurf/memories/global_rules.md，始终生效。
• 任意目录中的 AGENTS.md。
• 系统级（Enterprise）：/Library/Application Support/Devin/rules/*.md、/etc/devin/rules/*.md 或 C:\ProgramData\Devin\rules\*.md。

格式

使用 Markdown；工作区规则以 YAML frontmatter 开头。trigger 可设为 always_on、model_decision、glob 或 manual；glob 规则需提供 glob 模式，model_decision 规则需提供 description。global_rules.md 上限为 6,000 个字符，每个工作区规则文件上限为 12,000 个字符。

Front matter 键： triggerglobsdescription

---
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.

优先级与合并

.devin/ 的优先级高于 .windsurf/。系统规则会与工作区规则和全局规则合并，不会覆盖它们；global_rules.md 和根目录下的 AGENTS.md 始终生效。规则会从工作区、其子目录以及一直到 git 根目录的父目录中查找。

可读取该文件的工具

提示

• 在 .devin/rules/ 中创建新规则；仅为旧版安装保留 .windsurf/rules/。
• 对于仅在相关时才应由 agent 引入的指导内容，使用 trigger: model_decision，并提供清晰的 description。
• 自动生成的 Memories 仅适用于旧版 Cascade agent，不适用于现为默认选项的 Devin Local。

其他指令文件