عن المشروع

Jules Prompts هي مكتبة منسقة من مهام البرمجة القابلة للقراءة آليًا، ومهارات الوكلاء، وتجهيزات الإخفاق المزروعة المصممة لوكلاء البرمجة. الاسم تاريخي؛ التعليمات مستقلة عن الأدوات ولا تعتمد على أي منتج محدد مثل Jules أو Claude Code أو Codex أو Cursor. يتم تنظيم المستودع في عدة طبقات: - `_prompts/`: نص الإجراءات الأساسي، بما في ذلك موقع ويب وفهرس JSON وأوامر MCP المائلة. - `skills/`: نفس النص منسق كمهارات وكلاء، مولّد من `_prompts/`، جاهز للنسخ إلى `.claude/skills/` أو `.agents/skills/`. - `fixtures/`: مستودعات مصغرة تحتوي على عيوب مزروعة لتوضيح كيفية فشل المهارات. - `plugin/`: المكتبة بأكملها كحزمة قابلة للتثبيت مع بيان ومهارات وأوامر مائلة. - `library.json`: قائمة قابلة للقراءة آليًا لكل إجراء وفئته ومستواه. يتم فحص جميع المخرجات المولدة بايتًا ببايت في CI لضمان بقائها متزامنة مع المصدر. إضافة تنسيق إخراج جديد هي إدخال واحد في قائمة `TARGETS` في `scripts/emit.py`. تُصنف الإجراءات على أنها `core` ما لم تُعلَّم بـ `status: legacy`. تعالج إجراءات core الإخفاقات التي يواجهها الوكلاء فعليًا، بينما إجراءات legacy هي نصوص مهام عامة من 2025 تظل مفيدة ولكنها ليست ما يجعل هذه المكتبة فريدة. تتضمن المكتبة مبدأً ثابتًا لـ `AGENTS.md` في `harness/AGENTS.md` لضمان تفعيلها عندما لا يتم تحديد أي مهارة. تُقدَّم أدلة البدء في `PROMPTS_GUIDE.md` (يشرح كل موجه والتسلسل الموصى به) و`ENVIRONMENT_SETUP.md` (تحضير مستودع لاستنساخ الوكلاء وتثبيتهم واختبارهم). تشمل خيارات الاستخدام: - كمهارات وكلاء: انسخ أدلة المهارات إلى `.claude/skills/` والصق `harness/AGENTS.md` في `AGENTS.md` الخاص بالمشروع. - كخادم MCP: قم بتكوين الخادم في `mcpServers` لعرض الموجهات كأوامر مائلة في Claude Code وClaude Desktop وVS Code/Copilot Chat وWindsurf وZed. يقرأ الخادم المستودع مباشرة، وتُعرض العناصر النائبة مثل `<PR_URL_OR_DIFF_RANGE>` كوسائط. - للبشر: انسخ نص ملف الموجه بعد YAML front matter والصقه في إدخال تعليمات الوكيل. - للوكلاء: اجلب `https://jules-prompts.wecanuseai.com/prompts.json`، واختر موجهًا حسب العنوان/الوصف/الفئة، واجلب الموجه المعروض من عنوان URL الخاص به أو اقرأ `_prompts/<slug>.md`. - ضد التجهيزات: استخدم `python scripts/score_fixture.py fixtures/unfailable-tests path/to/REPORT.md` لتقييم تجهيزة، مع أحكام holds/broken/skipped وسطر تغطية. تؤكد إرشادات المساهمة على إضافة موجهات فقط للمهام المتكررة غير المغطاة بالفعل، والحفاظ على توافق YAML front matter، وكتابة تعليمات مستقلة عن الأدوات، وإعادة توليد المهارات، وتحديث الأدلة وسير العمل، وإضافة تجهيزات للموجهات التي تلتقط الإخفاقات، واجتياز فحوصات السلامة.