بنية العامل
كيف يُسقِط Apothem حزمة قدرات عاملة واحدة عبر سبعة عشر إطار عمل ذات أسطح خطافات وصيغ قواعد متباينة.
هذه صفحة مواصفات تقنية موجَّهة للمطوّرين. تستخدم مفردات Apothem الداخلية — أصناف المحوّلات، المُجسِّدات، بيان الانتشار، تقارب اصطلاحات الأشقاء — دون تبسيطها لجمهور عام.
يقرأ Apothem ملفًا تعريفيًا مشتركًا واحدًا (~/.config/apothem/profile.yaml)
ويُجسِّد تهيئة أصلية لإطار العمل لسبعة عشر محوّلًا مُسجَّلًا. لا تتشارك أُطُر العمل في
نموذج قدرات عاملة واحد: بعضها يكشف عن خطافات قبل استدعاء الأداة، وبعضها يشغّل
القواعد من ملفات .md مسطّحة، وبعضها يُضمِّن كل قاعدة في ملف تعليمات واحد،
وبعضها يُجسِّد تهيئة مدفوعة بالملف التعريفي وقت التثبيت. تُخطّط هذه الصفحة هذا
التباين والانضباط الذي يطبّقه Apothem عبره.
مصفوفة القدرات العاملة لكل إطار عمل
تغطّي المصفوفة أدناه أُطُر العمل السبعة عشر جميعها. الأعمدة: سطح خطاف PreToolUse الذي يوصّله المحوّل (وحيث يوثّق إطار العمل خطافات لا يسجّلها المحوّل، تذكر الخلية ذلك)، والصيغة التي يستخدمها Apothem لتفعيل القواعد، وصنف المحوّل (انظر أصناف المحوّلات)، وما إذا كان المحوّل يُجسِّد تهيئة أصلية عبر مُجسِّد.
| إطار العمل | سطح خطاف PreToolUse | صيغة تفعيل القواعد | صنف المحوّل | المُجسِّد |
|---|---|---|---|---|
| antigravity | سطح خطاف أصلي موجود؛ مادة دعم Apothem فقط | GEMINI.md بالإضافة إلى قواعد إضافة Antigravity CLI | الصنف I | لا يوجد |
| claude-code | PreToolUse / PostToolUse / Stop / SessionStart أصلي | قواعد .md مسطّحة تحت rules/ | الصنف II-A | لا يوجد (قوالب إعدادات المورّد) |
| codebuddy | SessionStart وPostToolUse أصليان في .codebuddy/settings.local.json؛ بلا حارس PreToolUse (لا يوثّق المورّد additionalContext هناك) | ملف قواعد المشروع .codebuddy/rules/apothem-rules.md | الصنف I | لا يوجد |
| codex | خطافات دورة الحياة الأصلية عبر hooks.json | AGENTS.md بالإضافة إلى قواعد دعم تشير إليها المهارات المثبَّتة | الصنف I | لا يوجد |
| cursor | sessionStart أصلي في .cursor/hooks.json الخاص بالمشروع؛ لا خطاف لأحداث الأدوات بعد | ملف قواعد مساحة عمل .mdc واحد (واجهة MDC الأمامية: description / globs / alwaysApply) | الصنف I | لا يوجد |
| gemini-cli | سطح خطاف أصلي موجود؛ مادة دعم Apothem فقط | قواعد مُضمَّنة في GEMINI.md واحد | الصنف I | لا يوجد |
| github-copilot | sessionStart وpostToolUse أصليان في .github/hooks/apothem.json؛ بلا حارس preToolUse (لا يقرأ المورّد هناك سوى حقول الأذونات) | قواعد في .github/copilot-instructions.md | الصنف I | لا يوجد |
| glm | لا يوجد (خلفية نموذج؛ بلا سطح أدوات للعامل) | .apothem/providers/glm.toml تهيئة مورّد الخلفية (بلا حزمة قواعد) | الصنف I | لا يوجد |
| hermes | مادة دعم فقط | config.yaml بالإضافة إلى دليل مهارات خارجي | الصنف II-B | config.yaml |
| kimi-code | مادة دعم فقط | AGENTS.md بالإضافة إلى قواعد دعم تحت .kimi-code/.apothem/support/ | الصنف I | لا يوجد |
| kiro | SessionStart أصلي في .kiro/hooks/apothem.json؛ لا خطاف لأحداث الأدوات (يتجاهل المورّد مخرجاتها) | ملف التوجيه .kiro/steering/apothem-rules.md | الصنف I | لا يوجد |
| open-claw | مادة دعم فقط | openclaw.json بالإضافة إلى دليل مهارات إضافي | الصنف II-B | openclaw.json |
| opencode | مادة دعم فقط | JSON مُجسَّد من الملف التعريفي بالإضافة إلى الأوامر والمهارات والعوامل الأصلية | الصنف II-B | opencode.json |
| qwen-code | PreToolUse / Stop / SessionStart أصلي | QWEN.md بالإضافة إلى الأوامر والمهارات والعوامل الأصلية | الصنف II-B | settings.json / QWEN.md |
| trae | لا يوجد | ملف قواعد المشروع .trae/rules/apothem-rules.md | الصنف I | لا يوجد |
| windsurf | SessionStart وPostToolUse أصليان لـ Devin Local في .devin/config.local.json؛ بلا حارس PreToolUse (لا يوثّق المورّد قناة سياق هناك) | ملف قواعد واحد في .devin/rules/ | الصنف I | لا يوجد |
| zed | لا يوجد | ملف .rules مسطّح في جذر المشروع | الصنف I | لا يوجد |
ملاحظات على المصفوفة:
- claude-code هو المحوّل ذو السطح الأصلي الأوسع. يحمل خطافات PreToolUse وPostToolUse وStop وSessionStart الأصلية، ويشحن قوالب إعدادات المورّد. ويكتب كتلة واحدة مُدارة محدودة بعلامات حارسة داخل
CLAUDE.md، ويُبقي نثر المُشغِّل خارج العلامات الحارسة دون تغيير. - codex يثبّت خطافات دورة الحياة الأصلية عبر
hooks.json، ويحوّل العوامل إلى TOML، ويغلّف موجّهات الأوامر كمهارات Codex، ويتركconfig.tomlملكًا للمشغّل. - antigravity يُبقي
~/.gemini/GEMINI.mdمرساةَ السياق العامة، ويثبّت إضافة Apothem تحت~/.gemini/antigravity-cli/plugins/apothem/. تُحفَظ ملفات الخطافات كمادة دعم إلى أن يتولّى المحوّل ترجمة مخطط خطافات Antigravity. - cursor يفعّل القواعد عبر ملف
.mdcواحد يحمل واجهة MDC الأمامية للمورّد (description،globs،alwaysApply)؛ ولا يكتب المحوّل ملف.cursorrulesالمفرد. - windsurf يستخدم
.devin/rules/؛ ولا يكتب المحوّل ملف.windsurfrulesالمفرد. - hermes وopen-claw يُجسِّدان ملفات تهيئة أصلية، ويوصّلان أدلة مهارات دعم Apothem عبر إعداد دليل المهارات الموثَّق لدى كل إطار عمل. وتبقى الحزم المشتركة غير المدعومة تحت أشجار دعم يملكها Apothem.
- qwen-code يُجسِّد مفاتيح
settings.jsonالموثَّقة للسياق وإرسال الخطافات، ثم يستخدم أدلة الأوامر والمهارات والعوامل الأصلية لـ Qwen.
انضباط التنسيق عبر أُطُر العمل
يطبّق Apothem تقارب اصطلاحات الأشقاء: يُسقَط سير العمل القابل للاستدعاء
من قبل المشغّل نفسه في الاصطلاح الأصلي لكل إطار عمل بدلًا من فرضه في صيغة مشتركة
واحدة. القاعدة التي تُفعَّل كملف .md مسطّح تحت claude-code تصبح قاعدة مساحة
عمل .mdc تحت cursor، وقسمًا مُضمَّنًا من GEMINI.md تحت gemini-cli، ومرجعًا
متسلسلًا في QWEN.md الخاص بـ qwen-code بالإضافة إلى أدلة الاكتشاف الأصلية —
النية ذاتها، بلهجة كل إطار عمل.
تعيش الحزمة الرئيسية المعيارية في:
src/apothem/{rules,commands,skills,agents,output-styles,hooks,conformity,statuslines}/ينشر كل محوّل مجموعة فرعية من هذه الحزمة. تُعلَن المجموعة الفرعية لكل إطار عمل في
src/apothem/lib/propagation-manifest.yaml؛ والبيان هو المصدر الوحيد للحقيقة
حول أيّ القطع تصل إلى أيّ إطار عمل وبأيّ صورة. لا يخترع المحوّل قطعًا خارج البيان
أبدًا، ولا يُسنِد البيان أبدًا قطعة إلى إطار عمل يفتقر إلى السطح اللازم لاستضافتها.
شرح أصناف المحوّلات
يصنّف Apothem المحوّلات في ثلاثة أصناف بحسب كيفية ترجمتها للملف التعريفي المشترك إلى مُخرَج أصلي لإطار العمل.
- الصنف I — الانتشار الخام. ينسخ المحوّل قطع الحزمة الرئيسية المعيارية (مجموعة فرعية مُعلَنة في البيان) مباشرة إلى موقع تهيئة إطار العمل دون خطوة تجسيد. لا يوجد مُجسِّد. تنتمي antigravity وcodebuddy وcodex وcursor وgemini-cli وgithub-copilot وglm وkimi-code وkiro وtrae وwindsurf وzed إلى الصنف I.
- الصنف II-A — خام + قوالب إعدادات مرتبطة بالمورّد. ينشر المحوّل القطع خامًا ويُدير إضافةً إلى ذلك قوالب إعدادات خاصة بالمورّد مرتبطة بمخطط المورّد. تنتمي claude-code إلى الصنف II-A.
- الصنف II-B — مُجسِّد سطح واحد مُجسَّد من الملف التعريفي. يُجسِّد المحوّل الملف التعريفي المشترك في سطح تهيئة أصلي واحد عبر مُجسِّد. تنتمي hermes وopen-claw وopencode وqwen-code إلى الصنف II-B.
السلوك وقت التجسيد
يظهر تمييز الصنف وقت التجسيد — عندما يُشغّل المشغّل واجهة سطر الأوامر مقابل إطار عمل:
apothem install --harness <H>ينشر المجموعة الفرعية من البيان لـ<H>ويُجسِّد، بالنسبة لمحوّلات الصنف II-A / II-B، التهيئة الأصلية لإطار العمل.apothem verify --harness <H>يتحقق من أن الملفات المُدارة موجودة وقابلة للتحليل. ومع--profile PATHيتحقق منها أيضًا مقابل ما كان سيُنتجه ذلك الملف التعريفي ويفشل عند الانحراف.apothem statusيُبلّغ عمّا إذا كان كل إطار عمل مثبَّتًا وعمّا إذا كان قد انحرف عن الملف التعريفي المشترك الحالي.apothem doctorيُبلّغ عن سلامة كل إطار عمل عبر كل محوّل مُسجَّل:okأوnot_installedأوneeds_projectأوverify_failedأوhook_failedأوerror.
انظر مرجع واجهة سطر الأوامر لأسطح الأوامر الكاملة.
تصنيف التباين
تتباين أُطُر العمل السبعة عشر على ثلاثة محاور. كل فارق بين إطار عمل وآخر في المصفوفة يختزل إلى أحد هذه المحاور.
| المحور | المدى المرصود عبر أُطُر العمل السبعة عشر |
|---|---|
| سطح الخطافات | متعدد الأحداث أصلي (claude-code، codex، qwen-code) → أصلي على الأحداث التي يسلّمها المورّد إلى النموذج (codebuddy: SessionStart وPostToolUse؛ cursor: sessionStart؛ github-copilot: sessionStart وpostToolUse؛ kiro: SessionStart؛ windsurf: SessionStart وPostToolUse) → مادة خطافات دعم فقط (antigravity، gemini-cli، hermes، kimi-code، open-claw، opencode) → لا خطاف يسجّله المحوّل (glm، trae، zed) |
| صيغة تفعيل القواعد | .md مسطّح (claude-code) → قواعد الإضافة (antigravity) → مساحة عمل .mdc (cursor) → قواعد الدليل (codebuddy، trae، windsurf) → ملف التوجيه (kiro) → ملف مسطّح في جذر المشروع (zed) → ملف مُضمَّن واحد (codex، gemini-cli، github-copilot، kimi-code) → مادة دعم مُشار إليها من التهيئة (hermes، open-claw، opencode، qwen-code) → تهيئة مورّد خلفية (glm) |
| صنف المحوّل | الصنف I انتشار خام → الصنف II-A خام + إعدادات المورّد → الصنف II-B سطح واحد مُجسَّد من الملف التعريفي |
مهمة Apothem هي إبقاء نية مشغّل واحدة متماسكة ثابتة بينما تتباين هذه المحاور الثلاثة لكل إطار عمل. بيان الانتشار وعقد صنف المحوّل هما الآليتان اللتان تُبقيان تلك النية مستقرة عبر التباين.