سير العمل الأساسية

يوفّر Apothem أربع قدرات أساسية: ملف تعريف حوكمة مشترك، ومجموعة قواعد، وخط أنابيب تخطيط منظَّم، وبوابة مطابقة في الزمن الحقيقي.

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

يقع ملف تعريف Apothem الخاص بك في ~/.config/apothem/profile.yaml ما لم تمرّر --profile PATH. وهو مصدر الحقيقة الوحيد الذي يشتقّ منه كل محوِّل بيئة تهيئته الأصلية:

identity:
  name: "Example User"
preferences:
  style: "concise"
rules:
  - "Validate external input before writing files."

أنشئ ملف التعريف وافحصه:

apothem profile init
apothem profile show --json

القاعدة الأولى

أضِف قواعد مشتركة إلى YAML ملف التعريف، ثم أعِد تجسيد البيئة المختارة. وعندما تتضمّن تلك القواعد بيانات أمثلة، استخدم نائبات وهمية حتى لا تقع أيّ هويّة أو بيانات اعتماد حقيقية في ملف تعريف مشترك أو في تشغيل CI.

apothem profile set rules '["Always include a brief summary at the end of every response."]'
apothem update --harness claude-code
apothem verify --harness claude-code

الخطة الأولى

يعمل خط الأنابيب /plan داخل أداتك البرمجية بوصفه أوامر شرطة مائلة، لا عبر ملف Apothem التنفيذي apothem. بمجرد تثبيت بيئة، ابدأ خطة من محادثة الأداة:

/plan-spec

يصقل /plan-spec نثرك إلى مواصفة، ويجسّد /plan-generate مجموعة خطط ضمن <project-root>/.apothem/plans/{suite}/. راجع مرجع أوامر خط الأنابيب للاطّلاع على التدفق الكامل.

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

شغّلها من جذر المستودع:

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

تُجري جميع فحوص المطابقة الآلية وتُبلِّغ بالنجاح/الفشل لكل شريط.