كيف تنشئ ملفات تعليمات مفيدة لوكلاء الذكاء الاصطناعي

يفيد ملف التعليمات عندما يحول معرفة المستودع إلى إجراءات يستطيع الوكيل اتباعها: الأمر الذي يثبت التغيير، والمجلدات المسموح تعديلها، والملفات المولدة التي يجب تجنبها، والمثال الذي يمثل النمط المفضل. قد تبدو أسماء الملفات متبادلة، لكن قواعد تحميلها ليست كذلك. لكل من AGENTS.md وCLAUDE.md وقواعد مشروع Cursor وSKILL.md أعرافه الخاصة في النطاق والتفعيل والبيانات والأولوية.

اكتب لمساهم جديد يستطيع فحص الشيفرة لكنه لا يستطيع استنتاج عادات الفريق. اذكر متطلبات قابلة للملاحظة بدلاً من رغبات شخصية: العبارة `شغّل pnpm test:api بعد تغيير src/api` قابلة للاختبار، أما `كن حذراً` فليست كذلك. ضع القواعد العامة قرب جذر المستودع والاستثناءات الضيقة قرب الملفات التي تحكمها عندما يدعم العميل التسلسل الهرمي. اربط بالأمثلة المعتمدة بدلاً من نسخ دليل أسلوب كامل سيتقادم.

اختر العميل المستهدف قبل الكتابة. حدد النطاق والأهداف المسموح بها والمسارات المحمية وأوامر التجهيز والتحقق والحالات التي تتطلب موافقة بشرية. أضف أمثلة موجزة للأعراف التي لا يستطيع منسق أو اختبار فرضها. في Cursor اختر نموذج التفعيل ووفر بيانات `.mdc` الأمامية. وفي المهارة طابق اسم المجلد مع حقل `name`، واشرح ما تفعله ومتى تستخدم، وانقل الموارد الطويلة إلى مراجع نسبية مركزة.

تأتي قواعد الصيغ من التوثيق الحالي لـAGENTS.md لدى OpenAI وذاكرة Claude Code وقواعد Cursor ومواصفة Agent Skills. وعندما تختلف الأنظمة، يحكم توثيق العميل المحدد نصيحة المسار والتفعيل والأولوية.

خذ قاعدة واحدة لمستودع متعدد الحزم: يجب أن تتبع التغييرات داخل `src/api/**` نمط الخدمات القائم، وألا تعدل `migrations/**`، وأن تنجح في `pnpm test:api`. في AGENTS.md الجذري اشرح القاعدة العامة ودع ملفاً متداخلاً يضيف استثناء API أضيق. في CLAUDE.md احتفظ بما يخص ذاكرة مشروع Claude Code. وفي قاعدة Cursor بصيغة `.mdc` اضبط النمط على `src/api/**/*.ts`. وفي SKILL.md استخدم اسماً مثل `api-change-review` ووصفاً يوضح المحفز وخطوات تحقق مرتبة.

التوجيه الفعال = نطاق منطبق + إجراء واضح + دليل تحقق. التعليمة الطويلة التي بلا قاعدة تفعيل أو أمر إثبات أضعف من قاعدة قصيرة موضوعة في المجلد الصحيح ومدعومة باختبار.

تختلف الأولوية بين العملاء، وقد يتعارض ملفان منطبقان. يتجاهل Cursor ملف `.md` عادياً داخل `.cursor/rules` لأن قواعد المشروع تحتاج بيانات `.mdc`. تحد مواصفة Agent Skills الأسماء وتلزم تطابقها مع المجلد الأب وتعد `allowed-tools` ميزة تجريبية. كما قد تتقادم التعليمات عند تغير الأوامر أو المسارات. والأهم أن توجيه الطلب ليس مصادقة أو تفويضاً أو عزلاً أو مخزناً للأسرار؛ طبّق الأمان عبر المنصة ونظام التشغيل.

عالج أخطاء الصيغة المانعة ثم راجع المحفزات والأوامر ومسارات الملفات والنطاق والحدود وحجم الرموز وخطوات التحقق القابلة للاختبار. وانتبه إلى خطأ متكرر: استخدام نصائح عامة أو لصق قيم سرية أو حذف بيانات SKILL.md المطلوبة أو إعداد قاعدة Cursor مرتبطة تلقائياً دون أنماط ملفات.

اختر AGENTS.md أو CLAUDE.md أو قاعدة Cursor أو SKILL.md، وأكمل حقول النطاق وسير العمل، وأنشئ المسودة، واقرأ نتائج التحقق. صحح البيانات والأوامر الغامضة قبل نسخ الملف إلى مساره المستهدف الدقيق.

المدخلات: الصيغة المستهدفة وسياق المشروع والنطاق والأوامر والقيود والأمثلة والبيانات الخاصة بالصيغة. المخرجات: ملف تعليمات واحد قابل للنسخ مع تشخيصات محلية ومسار مقترح. لا يثبت التوليد الملف ولا يثبت أن الوكيل سيلتزم به.

تُحرر التعليمات محلياً ولا يتم استدعاء نموذج. تنشئ الحقول الموجهة مسودة حتمية تبقى قابلة للتحرير الكامل مع أدوات التنسيق والتراجع والإعادة والمعاينة الفورية والعرض الموسع وحماية التعديلات اليدوية.