صياغة قواعد مشروع لوكيل برمجة
ملف قواعد قصير (مثل AGENTS.md) يوثّق أوامر مشروعك وحدوده وأعرافه.
- النوع
- ملف قواعد
- المستوى
- متقدم
- الوقت
- نحو 20 د
تعتمد النتيجة على الأداة والنموذج وما تُدخله.
معاينة النتيجة
مثال: كتبه فريق التحرير لدينا، وليس مخرجات حقيقية للذكاء الاصطناعي.
## الأوامر - الاختبارات: python3 -m pytest - البناء: python3 build.py ## ممنوع دائمًا - لا تقرأ الأسرار ولا تطبعها، لأنها تنتهي في السجلات. - لا force push، لأن التزامات الآخرين تضيع. ## اسأل أولًا - قبل إضافة أي تبعيات…
التعبئة
ما تكتبه يبقى في نافذة المتصفح هذه. نحن لا نحفظ شيئًا ولا نرسله.
- مولّد مواقع ثابتة بلغة Python
- متجر إلكتروني بواجهة React
- واجهة REST لتطبيق جوال
- لوحة داخلية لأرقام المبيعات
- أداة سطر أوامر لتحويل الملفات
- Python 3.12, pytest
- Node 22, TypeScript, Vitest
- React, Vite, Playwright
- Go 1.23, go test
- Java 21, Maven, JUnit 5
- python3 -m pytest
- npm test
- pnpm test
- go test ./...
- cargo test
- python3 build.py
- npm run build
- pnpm build
- go build ./...
- cargo build --release
- عدم قراءة الأسرار أبدًا، لا force push، لا تبعيات جديدة دون سؤال
- عدم تغيير بنية قاعدة البيانات دون سؤال
- عدم تعديل الملفات المولّدة يدويًا
- لا تغيير في شيفرة الدفع دون مراجعة
- الحفاظ على توافق الواجهة العامة مع الإصدارات السابقة
موجّهك
اكتب مسودة ملف قواعد لوكيل برمجة بالذكاء الاصطناعي في مشروعي. المشروع: [المشروع] التقنيات: [التقنيات] الأوامر: الاختبارات بـ [أمر الاختبار]، والبناء بـ [أمر البناء]. حدود صارمة: [الحدود] البنية: 1. نظرة عامة على المشروع في ثلاث جمل. 2. الأوامر. 3. أسلوب الشيفرة والأعراف. 4. ما يجب ألا يفعله الوكيل أبدًا. 5. متى يجب أن يسأل أولًا. 60 سطرًا على الأكثر، بصيغة Markdown، وقواعد محددة بدلًا من نصائح عامة.
أدوات مناسبة
أدوات من دليلنا يعمل معها هذا الموجّه جيدًا.
- Claude Code الأسعار والحدود
- OpenAI Codex الأسعار والحدود
- Cursor الأسعار والحدود
طريقة الاستخدام
- املأ الحقول بالأوامر الحقيقية لمشروعك.
- أنشئ المسودة واحذف كل ما هو خاطئ أو عام أكثر من اللازم.
- احفظ الملف بالاسم الذي يقرؤه وكيلك، وتوضح وثائق الأداة هذا الاسم.
- بعد بضع مهام، تحقّق من القاعدة الناقصة أو المتجاهَلة وأضفها.
يعمل في هذه الأدوات
تعمل الموجّهات في كثير من أدوات المحادثة والتوليد. هذه المجموعة مختارة من كتالوجنا، والأسعار كما تظهر في صفحة كل أداة.
- Claude Code الأسعار في صفحة الأداة
- OpenAI Codex خطة مجانية
- Cursor خطة مجانيةابتداءً من 8 USD شهريًا
- GitHub Copilot خطة مجانيةابتداءً من $10
لماذا ينجح هذا؟
يعمل الوكلاء بموثوقية أكبر مع قواعد قليلة قابلة للتحقق مقارنة بالنصوص الطويلة. ووضع الأوامر والحدود في البداية يمنع الأخطاء الأكثر شيوعًا.
نصائح
- اكتب القواعد في صيغة تعليمات مع السبب: «لا تفعل X أبدًا، لأن Y». هذا يساعد الوكيل في الحالات الحدّية.
- ضع روابط للوثائق الموجودة بدلًا من نسخها إلى ملف القواعد.