Apothem مقابل تهيئة Cursor اليدوية
صيانة قواعد MDC الخاصة بـ Cursor تحت .cursor/rules/ يدويًّا، مقابل تحويلها من الملف التعريفي المشترك لـ Apothem.
يقرأ Cursor القواعد بصيغة MDC تحت .cursor/rules/.
تتطلّب صيغة MDC حقول frontmatter — description
وglobs وalwaysApply. يُحوِّل محوِّل cursor في
Apothem ملف قواعد .mdc واحدًا من الملف التعريفي المشترك. تقابل هذه
الصفحة بين صيانة تلك التهيئة يدويًّا وإدارتها بـ Apothem.
مقارنة الجهد
| المهمة | تهيئة يدوية | يديرها Apothem |
|---|---|---|
| كتابة القواعد | كتابة كل ملف .mdc تحت .cursor/rules/ يدويًّا | مُحوَّلة من الذخيرة المشتركة |
| كتابة frontmatter لـ MDC | كتابة description / globs / alwaysApply يدويًّا لكل ملف | يولّدها المحوِّل |
| الحفاظ على صيغة قواعد واحدة | الاختيار يدويًّا بين قواعد MDC وملف .cursorrules واحد | يكتب المحوِّل ملف MDC واحدًا، .cursor/rules/apothem-rules.mdc، ولا يكتب .cursorrules |
| إبقاء القواعد متوائمة مع أُطُر العمل الأخرى | يدويًّا، لكل أداة | تلقائيًّا عند apothem update |
| مشاركة المهارات والأوامر القابلة لإعادة الاستخدام | نسخ كل مجلد مهارة يدويًّا إلى ~/.agents/skills/ وإبقاء النسخ محدَّثة | يكتبها المحوِّل في ~/.agents/skills/، نسخة واحدة لكل المشاريع، ويُحدِّثها عند apothem update |
| التحقّق من صحّة التهيئة | فحص يدوي | apothem verify --harness cursor --project <path> |
ما الذي يديره Apothem
يُحوِّل محوِّل cursor القواعد المشتركة إلى ملف .mdc واحد،
<project>/.cursor/rules/apothem-rules.mdc، ويولّد frontmatter الـ MDC
المطلوب (description وglobs وalwaysApply).
يكتب المحوِّل صيغة MDC القائمة على الأدلّة التي يقرأها
Cursor فقط؛ ولا يكتب ملف .cursorrules مفردًا. ويكتب أيضًا المهارات،
والأوامر المغلَّفة بوصفها مهارات، في ~/.agents/skills/، والقواعد والقوالب التي
تستشهد بها تلك المهارات في ~/.config/apothem/، وكلاهما في دليلك المنزلي.
يوثّق Cursor الخطّافات في ملفات hooks.json وعبر صيغة الإضافات الخاصة به.
لا يبني المحوِّل أيّ إضافة؛ بل يضيف مُدخلًا واحدًا لـ sessionStart إلى
.cursor/hooks.json الخاص بالمشروع، يحمّل تمهيد الجلسة، ويترك مُدخلاتك الخاصة كما
هي. ولا يسجّل أيّ حارس لاستدعاءات الأدوات، ولذا تقيم نيّة الحواجز الواقية في نصّ القواعد.
مسار الترحيل
- شغّل
apothem profile initلإنشاء الملف التعريفي المشترك إن لم تكن قد فعلت بعد. - انقل القواعد من
.cursor/rules/الموجود لديك (وأيّ.cursorrules) إلى الذخيرة المشتركة. - شغّل
apothem install --harness cursor --project <path>لتصييرapothem-rules.mdcمع frontmatter صحيح لـ MDC. - شغّل
apothem verify --harness cursor --project <path>للتأكّد من وصول التهيئة. - استخدم
apothem update --harness cursor --project <path>مع كل تغيير لاحق.