الأسئلة الشائعة

أسئلة شائعة، مرتّبة حسب التكرار.

ما هو apothem؟

إعداد محمول وغير معتمِد على المضيف يحوّل دليل المنزل لديك إلى إطار عمل للحوكمة وتوليد الأفكار والأتمتة للتطوير المدفوع بمساعد برمجي. وهو يجمع القواعد السلوكية، والمعايير الإبداعية، والأوامر المائلة، والعاملين المُفوَّضين الدائمين، والخطّافات، والمهارات في سطح واحد متماسك.

مع أي واجهات سطر أوامر للمساعد البرمجي يعمل؟

Apothem غير معتمِد على إطار العمل. تُسقِط المحوّلات الخاصة بكل إطار عمل ضمن src/apothem/harnesses/<harness>/ الملف التعريفي المشترك في دليل الإعداد الأصلي لكل أداة؛ والقائمة المعيارية موجودة في site/content/docs/harnesses/ وتغطّي حاليًا أُطُر العمل المدعومة التالية:

Claude Code, GitHub Copilot, Cursor, Gemini CLI, Codex, Windsurf, OpenCode,
Antigravity, Open-Claw, Hermes, Qwen Code, CodeBuddy, Kiro, Trae, Zed,
GLM (Z.ai), and Kimi Code

يُجسِّد محوّل Claude Code في ~/.claude/؛ ومُوزّع الخطّافات الخاص به محايد تجاه المضيف — إذ يحلّ جذر المنظومة من $CLAUDE_PROJECT_DIR أولًا، ثم $LLM_PROJECT_DIR، ثم يعود إلى $HOME/.claude.

هل يلزمني استخدام سلسلة حزمة الخطّة؟

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

كيف أخصّص القواعد دون عمل نسخة (fork) من المستودع؟

أضِف ملف قاعدتك الخاصّ ضمن src/apothem/rules/<my-rule>.md مع البيانات الأمامية (frontmatter) المعيارية. يلتقط مُحمِّل القواعد كل ملف يطابق النمط src/apothem/rules/*.md.

كيف أعطّل قاعدة مؤقتًا؟

إمّا أن تعيد تسمية الملف خارج النمط src/apothem/rules/*.md أو تنقله إلى دليل شقيق لا يفحصه المُحمِّل.

ما الفرق بين القواعد والمهارات والعاملين المُفوَّضين؟

• القواعد تحكم السلوك — التزامات دائمة التفعيل أو مُرشَّحة بالمسار يتّبعها المساعد.
• المهارات تقنيات قابلة لإعادة الاستخدام وقابلة للكشف — إشارة كشف، وإجراء، وخطّاف فرض.
• العاملون المُفوَّضون أدوار دائمة بقيود أدواتها الخاصّة ومُوجِّهات نظامها، يجري إرسالها عبر بروتوكول تنظيم العاملين.

كيف أبلّغ عن مشكلة أمنية؟

راجع SECURITY.md. القنوات المدعومة هي استشارات أمن GitHub (GitHub Security Advisories) و[email protected].

كيف أساهم؟

راجع المساهمة. باختصار: اقرأ CONTRIBUTING.md، واعمل نسخة (fork) من المستودع، وافتح طلب سحب (PR) مع قالب طلب السحب المعياري مُعبّأً، وتأكّد من نجاح فئات فحوص التكامل المستمرّ العشر.

أين تقع حالة المنظومة؟

• حالة الخطّة لكل حزمة تقع ضمن <project>/.apothem/plans/{suite}/.
• الذاكرة لكل مشروع تقع ضمن projects/{hash}/memory/.
• الذاكرة عبر المشاريع تقع ضمن memory/.
• المسوّدات لكل جلسة تقع ضمن <project>/.apothem/plans/{suite}/_inputs/.

هل يمكنني متابعة عمل طويل الأمد في جلسة جديدة أو على جهاز آخر؟

نعم. العمل طويل الأمد يُخرِج حالته الكاملة إلى حزمة .apothem/plans/ محلّية للمشروع — عقد استئناف إضافةً إلى بروتوكول بدء بارد —، بحيث لا يعيش العمل داخل سجلّ محادثة واحد. وبما أنّ الحالة موجودة في ملفّات مشروعك، فإنّ أي جلسة جديدة على أي حساب أو جهاز موجَّه إلى المشروع نفسه تستأنف العمل في مكانه. ولا يدفع Apothem الملفّات بين الحسابات بنفسه؛ بل تنتقل بالطريقة التي تنتقل بها ملفّات مشروعك أصلًا (التحكّم في الإصدارات، نسخة عمل مشتركة، دليل مُزامَن). راجع التخطيط القابل للاستئناف.

هل يحتاج Apothem إلى pip؟

لا — ليس للمحرّك نفسه. المحرّك شجرة مصدر مكتفية ذاتيًا باعتماديات مُضمَّنة — إذ يعمل بصيغة python -m apothem من أي نسخة عمل، أو ذاكرة npx المؤقتة، أو شجرة المُلحَق على Python 3.10 أو أحدث من النظام، ولا يُثبِّت أيًّا من شيفرته الخاصّة في site-packages (click وrich هما المتطلّبان المُسبَقان الوحيدان للمُفسِّر). الاستثناء الاختياري الوحيد: إذا كان click أو rich مفقودًا، فإنّ المُثبِّت يعرض تشغيل pip install لهذين الاثنين فقط نيابةً عنك — مع تأكيدك، أو عبر --yes / APOTHEM_AUTO_INSTALL_DEPS=1. أمّا حِزَم Apothem الخاصّة فلا تُثبَّت أبدًا في site-packages.

كيف تعمل الخطّافات دون حزمة مُثبَّتة؟

يُجسِّد apothem install مُوزّع الخطّافات وبوابة المطابقة ضمن جذر إطار العمل (في حالة Claude Code: ~/.claude/.apothem/support/hooks/ و ~/.claude/.apothem/support/conformity/)، وتستدعي إدخالات الخطّاف المُجسَّدة تلك النصوص بالمسار المُطلَق. وكلاهما نصوص مستقلّة من المكتبة القياسية (stdlib)، لذا تعمل الخطّافات على جهاز لم يرَ pip install قطّ.

كيف ألغي التثبيت بالكامل؟

شغّل apothem uninstall --harness <name> لكل إطار عمل مُثبَّت، وأزِل المحرّك وفق قناة تثبيتك، واحذف ~/.apothem/ (النُسَخ الاحتياطية) إضافةً إلى ~/.config/apothem/ (ملفك التعريفي) إن أردت عدم بقاء أي أثر. ويشرح دليل إلغاء التثبيت كل قناة.

ما الترخيص الذي تخضع له المنظومة؟

MIT — راجع LICENSE.