Apothem مقابل قواعد CodeBuddy الخام
لماذا تُمرَّر قواعد مشروع CodeBuddy عبر Apothem بدلًا من تأليف ملفات .codebuddy/rules يدويًا لكل مشروع.
يقرأ CodeBuddy قواعد المشروع من .codebuddy/rules/*.md. يمكنك تأليف تلك الملفات يدويًا، لكل مشروع، إلى الأبد. ويُولّد محوّل codebuddy في Apothem أحدها من الملف التعريفي المشترك، ويُبقيه متّسقًا عبر كل إطار عمل وكل مشروع. تقارن هذه الصفحة بين صيانة هذه التهيئة يدويًا وإدارتها بواسطة Apothem.
مقارنة الجهد
| المهمة | التهيئة اليدوية الخام | تديرها Apothem |
|---|---|---|
| كتابة القواعد | نسخ الانضباطات نفسها ولصقها في .codebuddy/rules/ لكل مشروع | تُولَّد من متن مشترك واحد |
| مصدر الحقيقة | ملفات كل مشروع على حدة | حزمة معيارية واحدة |
| إبقاء القواعد متوائمة عبر أُطُر العمل | إعادة اشتقاقها لكل أداة | تُسقَط تلقائيًا |
| تحديث القواعد | تحرير كل مشروع يدويًا | apothem update --harness codebuddy --project <path> |
| إزالة التهيئة | حذف يدوي | apothem uninstall مع نسخة احتياطية موسومة بالوقت |
| مشاركة المهارات والأوامر القابلة لإعادة الاستخدام | نسخ كل مجلد مهارة يدويًا إلى ~/.codebuddy/skills/ وإبقاء النسخ محدَّثة | يكتبها المحوّل في ~/.codebuddy/skills/، نسخة واحدة لكل المشاريع، ويُحدِّثها عند apothem update |
ما الذي يديره Apothem
يُولّد محوّل codebuddy القواعد المشتركة في ملف مخصّص هو <project>/.codebuddy/rules/apothem-rules.md. ويكتب أيضًا مجلدين في دليلك المنزلي تتشاركهما كل المشاريع: تذهب المهارات، والأوامر المغلَّفة بوصفها مهارات، إلى ~/.codebuddy/skills/، وتذهب القواعد والقوالب التي تستشهد بها تلك المهارات إلى ~/.config/apothem/rules/ و~/.config/apothem/templates/. أما ملف ذاكرتك CODEBUDDY.md، وأذوناتك وخوادم MCP في .codebuddy/settings.json، وأي ملفات قواعد أخرى تؤلّفها، فتبقى كلها ملكًا كاملًا للمشغِّل؛ يتعرّف المحوّل على تلك الأسطح لكنه لا يحرّرها أبدًا. ويُعاد توليد ملف القواعد عند كل apothem update تالٍ بعد أي تغيير في القواعد المشتركة.
مسار الترحيل
- شغّل
apothem profile initلإنشاء الملف التعريفي المشترك إن لم تكن قد فعلت ذلك بعد. - انقل الانضباطات من ملفات
.codebuddy/rules/الحالية لديك إلى المتن المشترك. - شغّل
apothem install --harness codebuddy --project <path>لتوليد الملفapothem-rules.mdإلى جانب قواعدك الخاصة التي لم تُمسّ. - شغّل
apothem verify --harness codebuddy --project <path>للتأكّد من وصول التهيئة إلى وجهتها. - استخدم
apothem update --harness codebuddy --project <path>مع كل تغيير لاحق.