بنية العامل

كيف يُسقِط 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	لا يوجد	ملف قواعد المشروع `.codebuddy/rules/apothem-rules.md`	الصنف I	لا يوجد
codex	خطافات دورة حياة `hooks.json` أصلية	`AGENTS.md` بالإضافة إلى قواعد دعم تشير إليها المهارات المثبَّتة	الصنف I	لا يوجد
cursor	لا يوجد	قواعد مساحة عمل `.mdc` (واجهة MDC الأمامية: `description` / `globs` / `alwaysApply`)	الصنف I	لا يوجد
gemini-cli	لا يوجد	قواعد مُضمَّنة في `GEMINI.md` واحد	الصنف I	لا يوجد
github-copilot	لا يوجد (إضافة IDE، بلا خطافات استدعاء الأداة)	قواعد في `.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	لا يوجد (خطافات عامل Kiro خارج نطاق المحوّل)	ملف التوجيه `.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	لا يوجد	قواعد في `.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> يتحقق من التهيئة المثبَّتة مقابل ما كان سيُنتجه الملف التعريفي الحالي ويُبلّغ عن الانحراف.
apothem doctor يُبلّغ عن حالة كل إطار عمل عبر كل محوّل مُسجَّل — مثبَّت / غائب / منحرف.

انظر مرجع واجهة سطر الأوامر لأسطح الأوامر الكاملة.

تصنيف التباين

تتباين أُطُر العمل السبعة عشر على ثلاثة محاور. كل فارق بين إطار عمل وآخر في المصفوفة يختزل إلى أحد هذه المحاور.

المحور	المدى المرصود عبر أُطُر العمل السبعة عشر
سطح الخطافات	متعدد الأحداث أصلي (claude-code، codex، qwen-code) → مادة خطافات دعم فقط (antigravity، gemini-cli، hermes، open-claw، opencode) → لا يوجد (codebuddy، cursor، github-copilot، glm، kimi-code، kiro، trae، windsurf، 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 هي إبقاء نية مشغّل واحدة متماسكة ثابتة بينما تتباين هذه المحاور الثلاثة لكل إطار عمل. بيان الانتشار وعقد صنف المحوّل هما الآليتان اللتان تُبقيان تلك النية مستقرة عبر التباين.