Skip to content
Apothem
محوّلات أُطُر العمل

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

يؤكّد أمر التحقّق ما يلي:

  1. وجود الإعداد الأصلي في المسار المتوقَّع.
  2. وجود جميع الحقول الإلزامية من الملف التعريفي المشترك.
  3. إبلاغ روتين التحقّق الخاص بالمحوّل عن النجاح.

التحديث

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-runfalseمعاينة التثبيت دون كتابة ملفات.

On this page