GitHub Copilot
محوّل إطار عمل Apothem لـ GitHub Copilot (GA).
المورّد: GitHub / Microsoft
اسم التثبيت: github-copilot
الحالة: GA
الإعداد الأصلي: <project>/.github/copilot-instructions.md
التثبيت
apothem install --harness github-copilot --project /path/to/projectيشتقّ المحوّل ملفّ تعليمات المشروع من قواعد Apothem المشتركة وسطح الحوكمة.
الملفات المكتوبة: <project>/.github/copilot-instructions.md
تعيين الملف التعريفي إلى الإعداد الأصلي
يقرأ المحوّل الملف التعريفي المشترك لـApothem ويعرض ملفّ تعليمات
Copilot على مستوى المستودع في كل عملية apothem install أو
apothem update. الملف التعريفي المشترك هو مصدر الحقيقة؛ وتُحفَظ نسخة
احتياطية من التعديلات المحلية للمشروع على الملفّ المُولَّد قبل أن تستبدل المزامنة
التالية المحتوى المُدار بواسطة Apothem.
ملاحظات التوافق
لا يكشف GitHub Copilot عن مسار تعليمات عامّ للمستخدم قائم على الملفات يمكن لهذا المحوّل إدارته. يستهدف Apothem ملفّ تعليمات نطاق المشروع الموثَّق، ويترك إعدادات المستخدم على مستوى بيئة التطوير المتكاملة في ملكية المشغّل.
يتعامل Apothem مع copilot-instructions.md بوصفه صوتًا واحدًا
بين أسطح تعليمات المساعد في المشروع: يتحقّق فحص التماسك متعدّد الأسطح في بوّابة
المطابقة من أنّ ادّعاءاته المشتركة تبقى متوائمة دلاليًا مع ملفات تعليمات المشروع
الأخرى، لذا لا يتلقّى Copilot أبدًا إرشادًا يتعارض مع ما تقرؤه بقيّة سلسلة
الأدوات.
التحقّق
apothem verify --harness github-copilot --project /path/to/projectيؤكّد أمر التحقّق ما يلي:
- وجود الإعداد الأصلي في المسار المتوقَّع.
- وجود جميع الحقول الإلزامية من الملف التعريفي المشترك.
- إبلاغ روتين التحقّق الخاص بالمحوّل عن النجاح.
التحديث
apothem update --harness github-copilot --project /path/to/projectيعيد اشتقاق ملفّ تعليمات المشروع من حالة الملف التعريفي المشترك الحالية.
إلغاء التثبيت
apothem uninstall --harness github-copilot --project /path/to/projectيزيل ملفات الإعداد الأصلية التي كتبها المحوّل. لا يتأثّر YAML الملف التعريفي المشترك ولا محرّك Apothem.
بوّابة المطابقة
python -m apothem.conformity.gate --all .استكشاف الأخطاء وإصلاحها
| العَرَض | الإصلاح |
|---|---|
| ملف الإعداد غير موجود | أعد تشغيل apothem install --harness github-copilot --project /path/to/project |
| فشل التحقّق | شغّل apothem update --harness github-copilot --project /path/to/project، ثم تحقّق مجدّدًا |
| محتوى إعداد غير متوقَّع | تحقّق من ~/.config/apothem/profile.yaml أو --profile PATH، ثم أعد تشغيل apothem update --harness github-copilot --project /path/to/project |
مفاتيح الضبط
| العَلَم | الافتراضي | الوصف |
|---|---|---|
--dry-run | false | معاينة التثبيت دون كتابة ملفات. |