تحرير الملف التعريفي

الهدف: غيّر قيمة في الملف التعريفي المشترك وادفعها إلى كل بيئة ثبّتّها.

المتطلّبات المسبقة

• واجهة apothem على PATH لديك (أو الصورة القائمة بذاتها: صدّر بـ PYTHONPATH="$HOME/.apothem/src" وشغّل python -m apothem، أو استخدم npx @ahmed-g-gad/apothem).
• ملف تعريفي في ~/.config/apothem/profile.yaml. أنشئ واحدًا عبر apothem profile init إن كان مفقودًا.

شكل الملف التعريفي

الملف التعريفي مستند YAML واحد. مفاتيحه عالية المستوى:

• identity (مطلوب) — name، بالإضافة إلى اختيارية role، email، website، github.
• preferences — language، style (concise / verbose / balanced), formatter، test_framework.
• rules — قائمة بسلاسل قواعد إضافية تُشارَك مع البيئات القادرة.
• seriousness — واحد من EXPLORING، PERSONAL_USE، SHARED, PUBLIC_LAUNCH.
• enforcement — مفاتيح تشغيل اختيارية (sprints، agent_teams، multitasking, continuous_execution، learning_loop)، وكل راية معطّلة افتراضيًا.
• harnesses — تجاوزات لكل بيئة مفهرسة بمُعرّف البيئة.
• exclude_harnesses — مُعرّفات بيئات تتخطّاها الأوامر الدفعية (--harness all).

الخطوات

1. افحص الملف التعريفي الحالي:

   apothem profile show

2. حرّره. افتحه في محرّر نظامك:

   apothem profile edit

   أو عيّن مفتاحًا منقّطًا واحدًا من سطر الأوامر. تُخزَّن القيمة حرفيًا (باستثناء true/false والإدخال الصريح [..]/{..}، فهذه تُحلَّل) ويُتحقّق من الملف التعريفي مقابل المخطط قبل الكتابة — يُرفض التعيين غير الصالح ويبقى الملف التعريفي على القرص دون تغيير:

   apothem profile set seriousness SHARED
   apothem profile set identity.name "Ada Lovelace"

3. أعد تجسيد البيئات لكي يصل التغيير إلى تهيئتها الأصلية. لبيئة بنطاق المستخدم:

   apothem update --harness claude-code

   لبيئة بنطاق المشروع، مرّر جذر المشروع؛ استخدم all لتحديث كل بيئة مثبَّتة:

   apothem update --harness cursor --project /path/to/project
   apothem update --harness all --project /path/to/project

التحقق

apothem profile show
apothem verify --harness all

يعكس profile show تحريرك؛ ويؤكّد verify أن التهيئة المُجسَّدة تطابق الملف التعريفي المحدَّث.

ذات صلة

• أضف بيئة لإخضاع بيئة جديدة لتحكّم الملف التعريفي قبل إعادة التجسيد.
• يغطّي التحديث ترقية المحرّك جنبًا إلى جنب مع خطوة إعادة التجسيد.