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

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

الملف التعريفي المشتركCopy Anchor Link

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

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

أنشئ الملف التعريفي إن لم يكن موجودًا بعد، ثم افحصه. تكتب المُثبِّتات بخطوة واحدة والأمر apothem install ملفًا تعريفيًا مبدئيًا في أول تشغيل، ويتوقّف profile init بخطأ ويترك الملف الموجود دون تغيير ما لم تمرّر --force.

apothem profile init
apothem profile show --json

القاعدة الأولىCopy Anchor Link

أضِف قواعد مشتركة إلى ملف 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

الخطة الأولىCopy Anchor Link

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

/plan-spec

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

بوابة المطابقةCopy Anchor Link

من نسخة مسحوبة من Apothem، شغّل:

PYTHONPATH=src python -m apothem.conformity.gate --all .

بعد التثبيت بالسكربت، شغّل:

PYTHONPATH="$HOME/.apothem/src" python3 -m apothem.conformity.gate --all .

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