واجهة APX CLI هي حلقة يومية، وليست لوحة بيانات

توقف عن التعامل مع APX CLI كلوحة تحكم عملاقة. تعامل معها كحلقة يومية صغيرة.

يعتمد التصميم على الفصل بين APC و APX. يظل APC في مستودعك (repo) كطبقة سياق محمولة. بينما يظل APX على جهازك كطبقة تشغيل (runtime) محلية. إذا حاولت جعل CLI يقوم بكل شيء، فستفقد الحد الفاصل بينهما.

حافظ على تركيز CLI من خلال هذا الروتين:

• سجل المشروع مرة واحدة. • تحقق من حالتك قبل العمل. • اقرأ الذاكرة الدائمة (durable memory) قبل طلب المساعدة. • تتبع الرسائل (tail messages) لمعرفة ما حدث بالفعل.

يصبح المشروع مشروع APX بمجرد احتوائه على AGENTS.md و .apc/project.json. يمكنك تسجيله باستخدام هذه الأوامر:

apx init apx project add .

يظل المستودع (repo) محمولاً لأن شجرة .apc/ تحتوي على العقد (contract). فهي تضم الوكلاء (agents)، والمهارات (skills)، والإعدادات (config). بينما يحافظ APX على حالة التشغيل (runtime state) محلياً على جهازك. وهذا يعني أنه يمكنك استنساخ مستودع إلى جهاز جديد واستعادة هيكل المشروع دون تاريخ التشغيل القديم.

عندما تبدأ العمل، تحقق من بيئة التشغيل أولاً:

apx status

يُظهر هذا حالة الـ daemon وحالة المحرك (engine). يساعدك ذلك في معرفة ما إذا كانت بيئة التشغيل المحلية هي المشكلة بدلاً من المستودع. إذا انتقل المشروع، فقم بإصلاح التسجيل:

apx project rebuild <project>

ذاكرة APX مخصصة للحقائق الدائمة. استخدم هذا الأمر لمراجعتها:

apx memory reviewer

لإضافة ملاحظة، أضف سطراً واحداً:

apx memory reviewer --append "Prefers short PR summaries"

لا تغذِّ النماذج بسياق خام. استخدم سياقاً مستقراً من خلال الذاكرة.

إذا كانت الذاكرة تخبرك بما يجب أن يكون صحيحاً، فإن الرسائل تخبرك بما حدث بالفعل. استخدم هذا لتدقيق النظام:

apx messages tail --channel runtime -n 20

حافظ على فصل هذه الأشياء الثلاثة:

  • memory.md: للحقائق الدائمة.
  • messages: للنشاط الأخير.
  • sessions: لسجل الاستدعاءات.

لا ينبغي لملف واحد أن يقوم بثلاث وظائف. يحدد APC المشروع، بينما يحدد APX ما حدث اليوم.

استخدم هذا التسلسل لتبقى على دراية بالوضع:

apx project list apx memory reviewer apx messages tail -n 20

تعمل واجهة CLI بشكل أفضل كعادة. استخدم المستودع (repo) للسياق المحمول. استخدم الجهاز لحالة التشغيل (runtime state). استخدم CLI للتحقق من الحد الفاصل كل يوم.

المصدر: https://dev.to/agentprojectcontext/the-apx-cli-is-a-daily-loop-not-a-dashboard-1o98

مجتمع تعليمي اختياري: https://t.me/GyaanSetuAi