Claude Code

المورّد: Anthropic اسم التثبيت: claude-code الحالة: GA الإعداد الأصلي: ~/.claude/

التثبيت

apothem install --harness claude-code

يقوم محوّل claude-code بتثبيت مجموعة Apothem المشتركة في شجرة الاكتشاف الأصلية لـClaude Code. تُثبَّت وكلاء Markdown، والقواعد، والمهارات، وأنماط المخرجات، ومساعدات شريط الحالة، والإعدادات في مواقعها الأصلية؛ كما تُغلَّف مطالبات الأوامر بصورة إضافية بوصفها مهارات لتبقى سير العمل القابلة لإعادة الاستخدام مرئية عبر سطح المهارات الحالي لـClaude Code.

الملفات المكتوبة: settings.json، وagents/، وrules/، وskills/، وstatuslines/، وoutput-styles/، وشجرة الدعم الفرعية apothem/ (apothem/hooks/، وapothem/conformity/، وapothem/schemas/، وapothem/templates/) تحت ~/.claude/. تُحوَّل ملفات الأوامر إلى أدلّة مهارات فرعية. يعمل موزّع الخطافات وبوّابة المطابقة من نسخهما المُجسَّدة — تستدعي مدخلات الخطافات في settings.json الملفّ ~/.claude/.apothem/support/hooks/dispatch.py والملفّ ~/.claude/.apothem/support/conformity/gate.py بالمسار المطلق، لذلك لا حاجة إلى حزمة apothem قابلة للاستيراد على المضيف.

لا يدير المحوّل ملفّ CLAUDE.md — فهذا الملفّ منطقة يملكها المشغّل. يبلغ سطح حوكمة Apothem إلى Claude Code عبر شجرة rules/ المُنتشَرة وخطّاف SessionStart، لا عبر CLAUDE.md مُجسَّد.

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

في كل عملية apothem install أو apothem update، ينشر المحوّل مجموعة apothem المشتركة إلى ~/.claude/ وفق بيان الانتشار. يستخدم المحوّل الأدلّة الأصلية مباشرةً حيثما أمكن ويحوّل مطالبات الأوامر إلى مجلدات مهارات. تُحفَظ نسخة احتياطية من العناصر الفرعية المُدارة بواسطة Apothem المطابقة الموجودة قبل استبدالها؛ وتُصان المدخلات غير ذات الصلة التي أنشأها المشغّل. يُدمَج settings.json بحيث تبقى المفاتيح التي أنشأها المشغّل قابلة للاستعادة.

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

لا تحدث أي ترجمة. يتحقّق التثبيت من أنّ الملف التعريفي جيّد التكوين وأنّ جميع ارتباطات الخطافات في settings.json قابلة للحلّ.

يطبّق Claude Code جميع ارتباطات الخطافات في settings.json عند كل بدء جلسة. يُتحقَّق من كل محوّل مقابل إطار عمله الأصلي الخاص — ولا يوجد إطار عمل «مرجعي» متميّز.

التحقّق

apothem verify --harness claude-code

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

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

التحديث

apothem update --harness claude-code

يعيد اشتقاق الإعداد الأصلي من الملف التعريفي المشترك الحالي. شغّله بعد تحديث حزمة apothem المثبّتة، حتى يعكس سطح الاتفاقيات المُنتشَر (الوكلاء، والقواعد، والمهارات، وأشرطة الحالة، وأنماط المخرجات) الإصدار الجديد. ملفّ CLAUDE.md يملكه المشغّل ولا يلمسه المحوّل أبدًا.

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

apothem uninstall --harness claude-code

يزيل ملفات الإعداد الأصلية التي كتبها المحوّل. لا تتأثّر حزمة apothem المثبّتة ولا مستودع المصدر.

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

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

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

مفاتيح الضبط