عن المشروع

GitHub Agentic Workflows (`gh-aw`) هو امتداد لـ GitHub CLI يتيح للمطورين تعريف أتمتة المستودعات المدعومة بالذكاء الاصطناعي باستخدام ملفات Markdown مع YAML frontmatter. يقوم الامتداد بترجمة كل سير عمل وكيلي إلى سير عمل GitHub Actions قياسي، مما يسمح لوكلاء الذكاء الاصطناعي بالعمل بأمان داخل GitHub Actions. صُممت سير العمل الوكيلية للمهام التي تتطلب استدلالاً أو تفسيراً، مثل فرز المشكلات، ومراجعة طلبات السحب، والتحقيق في فشل CI، وصيانة الوثائق، وتحليل التبعيات، وإعداد تقارير المستودع. وهي تكمّل، بدلاً من أن تحل محل، إجراءات GitHub Actions التقليدية المستخدمة في عمليات البناء الحتمية والاختبارات والفحص والنشر والنصوص القابلة لإعادة الإنتاج. تشمل محركات الذكاء الاصطناعي المدمجة GitHub Copilot وClaude Code وOpenAI Codex وGoogle Gemini وPi. تكون مهام الوكيل افتراضياً للقراءة فقط ومعزولة في بيئة آمنة، وعادةً ما تُطبَّق عمليات الكتابة المُهيأة في GitHub عبر مهام `safe-outputs` المُتحقق منها وبصلاحيات محددة النطاق. تُعد الأمان والصلاحيات والكتابات المُتحكم بها من الاهتمامات الأساسية في التصميم. يعتمد مسار مهمة الوكيل المدعوم افتراضياً على وصول للقراءة فقط إلى GitHub وتنفيذ معزول. تقوم المخرجات الآمنة بتخزين الكتابات المُهيأة مؤقتاً والتحقق منها وتطبيقها في مهام منفصلة بصلاحيات محددة النطاق. هذه الضوابط قابلة للتهيئة، لذا يجب على مؤلفي سير العمل مراجعة الصلاحيات والأدوات والوصول إلى الشبكة والملفات المُنشأة قبل النشر. البدء السريع: ثبّت الامتداد باستخدام `gh extension install github/gh-aw`، ثم اتبع دليل البدء السريع لاختيار محرك ذكاء اصطناعي وإضافة سير عمل نموذجي وتشغيله عبر GitHub Actions. تغطي الوثائق إنشاء سير العمل، واختيار محركات الذكاء الاصطناعي والمصادقة عليها، وأمثلة حسب المهمة، وبنية الأمان، والأسئلة الشائعة. يمكن لوكلاء الذكاء الاصطناعي وأدوات الاسترجاع استخدام فهرس مطالبات الوكيل المنشور، ومجموعة المطالبات الكاملة، وملخص المشروع القابل للقراءة بواسطة الذكاء الاصطناعي. ملاحظة: تم اكتشاف ثغرة أمنية في الإصدارات `>= 0.83.3, < 0.85.4`؛ وقد تم سحب تلك الإصدارات كإجراء وقائي.