Cline Rules (.clinerules/): مكانه وكيفية قراءته من الأدوات

قواعد Cline هي ملفات Markdown في .clinerules/، يدمجها Cline مع القواعد العامة ومع AGENTS.md. وتقيّد frontmatter الاختيارية الخاصة بالمسارات نطاق القاعدة بالملفات المطابقة.

مكان الملف

• مساحة العمل: .clinerules/*.md أو .cline/rules/*.md؛ يبحث Cline في كليهما.
• عام: Documents\Cline\Rules على Windows، و~/Documents/Cline/Rules على macOS وLinux، بالإضافة إلى ~/.cline/rules و~/Cline/Rules.
• يُكتشف تلقائيًا وجود ملفات مشتركة بين الأدوات: AGENTS.md و~/.agents/AGENTS.md و.cursorrules و.windsurfrules.

التنسيق

ملفات Markdown، ويمكن ترقيمها اختياريًا مثل 01-coding.md، مع إمكانية إضافة ترويسة YAML. تفعّل مصفوفة paths التي تضم أنماط glob القاعدة عند مطابقة أي نمط لملف ضمن السياق. إذا لم توجد ترويسة، تكون القاعدة مفعّلة دائمًا؛ أما paths: [] فتعني أنها غير مفعّلة مطلقًا، ويؤدي وجود YAML غير صالح إلى تفعيل القاعدة افتراضيًا.

مفاتيح 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.

الأولوية والدمج

تُدمج قواعد مساحة العمل والقواعد العامة، وتكون الأولوية لقواعد مساحة العمل عند التعارض. ويمكن تفعيل كل قاعدة أو إيقافها على حدة.

نصائح

• يشمل السياق المسارات المذكورة، وعلامات التبويب المفتوحة أو الظاهرة، والملفات التي يجري تحريرها والتعديلات المعلّقة.
• بما أن YAML غير الصالح يؤدي إلى تفعيل القاعدة افتراضيًا، فإن أي خطأ مطبعي في paths يجعلها مفعّلة دائمًا؛ لذا تحقّق منه بعد التحرير.
• أنشئ القواعد من لوحة Rules في VS Code أو باستخدام الأمر /newrule.

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