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

Gemini CLI

محوّل أداة Apothem لـ Gemini CLI (إصدار عام).

المورّد: Google اسم التثبيت: gemini-cli الحالة: إصدار عام الإعداد الأصلي: GEMINI.md و.gemini/ المحلّيان للمشروع

التثبيت

apothem install --harness gemini-cli --project /path/to/project

نطاق المحوّل هو المشروع. يثبّت ملفّ GEMINI.md الخاص بالمشروع، ويحوّل أوامر Apothem إلى أوامر شرطة مائلة بصيغة TOML خاصّة بـGemini، ويطبّع تعريفات المساعِدات المحلّية، ويضع مجموعات الدعم غير الأصلية تحت .gemini/.apothem/support/.

الملفات المكتوبة:

GEMINI.md
.gemini/commands/*.toml
.gemini/agents/*.md
.gemini/skills/
.gemini/.apothem/support/

تعيين الملف التعريفي إلى الإعداد الأصلي

يقرأ المحوّل مجموعات Apothem المشتركة ويوجّه كلّ واحدة منها عبر سطح متوافق مع Gemini. تبقى قواعد Markdown والقوالب ومادّة الخطافات تحت .gemini/.apothem/support/ لأنّها مادّة دعم، وليست دليل قواعد أصلي لـGemini.

ملاحظات التوافق

يبقى ~/.gemini/ منطقةً على نطاق المستخدم للأدوات التي تستخدم ملفًا تعريفيًا عامًّا لـGemini. لا يكتب محوّل Gemini CLI إلا في المشروع المُمرَّر عبر --project.

التحقّق

apothem verify --harness gemini-cli --project /path/to/project

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

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

التحديث

apothem update --harness gemini-cli --project /path/to/project

يحدّث GEMINI.md، والأوامر المُحوَّلة، وتعريفات المساعِدات المحلّية، والمهارات المثبّتة، وشجرة الدعم .gemini/.apothem/support/.

إلغاء التثبيت

apothem uninstall --harness gemini-cli --project /path/to/project

يزيل ملفات الإعداد الأصلي التي كتبها المحوّل. لا يتأثّر ملفّ YAML الخاص بالملف التعريفي المشترك ولا محرّك Apothem.

بوّابة المطابقة

python -m apothem.conformity.gate --all .

استكشاف الأخطاء وإصلاحها

العَرَضالإصلاح
ملف الإعداد غير موجودأعد تشغيل apothem install --harness gemini-cli --project /path/to/project
فشل التحقّقشغّل apothem update --harness gemini-cli --project /path/to/project، ثم تحقّق مجدّدًا
محتوى إعداد غير متوقَّعتحقّق من ~/.config/apothem/profile.yaml أو --profile PATH، ثم أعد تشغيل apothem update --harness gemini-cli --project /path/to/project

مفاتيح الضبط

العَلَمالافتراضيالوصف
--dry-runfalseمعاينة التثبيت دون كتابة ملفات.

On this page