Devin Desktop (Windsurf) rules: مكانه وكيفية قراءته من الأدوات

يقرأ Devin Desktop، وهو الاسم الجديد لـ Windsurf منذ 2026-06-02، ملفات القواعد من .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. الحد الأقصى لطول global_rules.md هو 6,000 حرف، ولكل ملف قواعد في مساحة العمل 12,000 حرف.

مفاتيح Frontmatter: 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/ للتثبيتات الأقدم فقط.
• استخدم trigger: model_decision مع وصف واضح للإرشادات التي ينبغي للوكيل استحضارها عند الحاجة فقط.
• تنطبق Memories المُنشأة تلقائيًا على وكيل Cascade القديم فقط، وليس على Devin Local، وهو الآن الخيار الافتراضي.

ملفات التعليمات الأخرى