محوّلات أُطُر العمل

يأتي Apothem مع سبعة عشر محوّل إطار عمل مدمجًا. يترجم كل محوّل الحزم المشتركة نفسها إلى ملفات أصلية للمنصّة حيث تدعمها المنصّة، وإلى أشجار دعم يملكها Apothem حيث لا تدعمها.

أُطُر العمل المدعومةCopy Anchor Link

يحتوي السجلّ المدعوم على سبعة عشر محوّلًا بالضبط. استخدم أسماء التثبيت هذه تحديدًا مع --harness، أو استخدم all للحصول على مجموعة السجلّ الحتمية:

antigravity
claude-code
codebuddy
codex
cursor
gemini-cli
github-copilot
glm
hermes
kimi-code
kiro
open-claw
opencode
qwen-code
trae
windsurf
zed

تقيم مصفوفة السجلّ المفصّلة، والمسارات المستهدفة، وحالات القدرات، ودعم MCP، وأدلّة تثبيت الاتفاقيات في مرجع السجلّ التقني.

تثبيت أُطُر عمل متعدّدةCopy Anchor Link

ثبّت إطار عمل واحدًا، أو استخدم all لتحديد السجلّ بترتيب حتمي. تتطلّب أُطُر العمل ذات نطاق المشروع --project PATH؛ ويشمل ذلك all لأنّ السجلّ يتضمّن أهدافًا ذات نطاق المستخدم وأهدافًا ذات نطاق المشروع معًا.

apothem install --harness claude-code
apothem install --harness cursor --project /path/to/project
apothem install --harness gemini-cli --project /path/to/project
apothem install --harness all --project /path/to/project

تحقّق من تثبيتاتكCopy Anchor Link

تحقّق من كل محوّل إطار عمل على حدة، أو استدعِ apothem doctor للحصول على ملخّص حالة التثبيت لكل محوّل عبر كل محوّل مُسجَّل:

apothem verify --harness claude-code
apothem verify --harness all --project /path/to/project
apothem doctor

كيف تعمل المحوّلاتCopy Anchor Link

ينفّذ كل محوّل بروتوكول HarnessAdapter المُسجَّل عبر نقاط دخول setuptools. عند التثبيت، تُحمِّل واجهة سطر الأوامر الملف التعريفي المشترك بصيغة YAML وتتحقّق منه، وتحلّ المحوّل عبر السجلّ، وتتحقّق من خطّة التجسيد، وتكتب الإعداد الأصلي للمنصّة إلى موقع المستخدم أو المشروع الأصلي لإطار العمل. وعند التحديث، تعيد الاشتقاق من حالة الملف التعريفي الحالية.

profile.yaml + packaged cohorts
    identity / preferences / rules
    commands / skills / delegated definitions / hooks / templates
         |
         +-- antigravity    --> ~/.gemini/GEMINI.md + ~/.gemini/antigravity-cli/plugins/apothem/
         +-- claude-code    --> ~/.claude/ native folders + ~/.claude/.apothem/support/
         +-- codex          --> ~/.codex/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
         +-- cursor         --> <project>/.cursor/rules/*.mdc + <project>/.cursor/agents/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
         +-- gemini-cli     --> <project>/GEMINI.md + <project>/.gemini/
         +-- github-copilot --> <project>/.github/copilot-instructions.md + <project>/.github/agents/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
         +-- windsurf       --> <project>/.devin/rules/ + <project>/.devin/agents/ + ~/.agents/skills/ + ~/.config/apothem/{rules,templates}/
         +-- ...

المهارات في دليلك المنزليCopy Anchor Link

تكتب سبعة محوّلات ذات نطاق المشروع ملف قواعد واحدًا في مشروعك (وستّة منها تكتب أيضًا مساعِدات Apothem هناك بوصفها ملفات عوامل فرعية؛ وتسمّي صفحة كل إطار عمل المجلّد)، وتكتب أيضًا مهارات Apothem، والقواعد والقوالب التي تستشهد بها المهارات، في مجلّدات داخل دليلك المنزلي:

cursor, github-copilot, windsurf, zed  ->  ~/.agents/skills/ (codex writes it too)
codebuddy                               ->  ~/.codebuddy/skills/
kiro                                    ->  ~/.kiro/skills/
trae                                    ->  ~/.trae/skills/
all seven                               ->  ~/.config/apothem/rules/ and templates/ (codex uses them too)

• كل تثبيت يسمّي مجلّدًا يكتب الملفات نفسها، لذا لا يهمّ الترتيب الذي تثبّت به، وتخدم نسخة واحدة كل المشاريع.
• يكتب التثبيت المجلّدات المنزلية أولًا. فإن فشل ذلك، يتوقّف قبل أن يغيّر المشروع، ولا يضيف أي ملف مهارة أو قاعدة إلى مستودعك.
• لا يُزيل إلغاء التثبيت مجلّدًا مشتركًا إلا حين لا يعود أي تثبيت آخر لـ Apothem يستخدمه، ويذكر أي تثبيت يُبقيه.
• مجلّد المهارة الذي يحمل اسم مهارة من Apothem ولم يكتبه Apothem يُترَك كما هو، مع تحذير.

تسرد صفحة كل إطار عمل مجلّداتها. ويُبيّن سجلّ أُطُر العمل أي الأدوات تتشارك أي مجلّد.

راجع تجريد محوّل إطار العمل للاطّلاع على مواصفة البروتوكول.