البدء السريع

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

في النهاية سيكون لديك إعداد إطار عمل عامل مُولَّد من ملف تعريفي كتبته بنفسك — وستعرف الأمر الوحيد الذي يدفع أي تغيير في الملف التعريفي مجددًا إلى أداة واحدة أو إلى جميع الأدوات.

ستستخدم Claude Code إطارَ عمل للمثال — فهو الإطار الافتراضي للمُثبِّت. بدِّل اسم المحوّل في أي خطوة لاستهداف أداة أخرى؛ تضمّ قائمة أُطُر العمل كل اسم مدعوم.

1. ثبِّت ApothemCopy Anchor Link

يُشحَن Apothem بوصفه زمن التشغيل المكتفي ذاتيًا — يعمل المحرّك مباشرةً من شجرة مصدره مع اعتماديّات مُضمَّنة. أمر واحد يجلب المصدر، ويضع المحرّك، ويُجسِّد أول إطار عمل لك. يتحقّق الأمر من الإصدار الموقَّع أولًا، لذا استورِد مفتاح توقيع المشرف مرةً واحدة قبل أول تثبيت، وتحقّق من أن البصمة هي 5C89 98F9 F241 7204 45D3 F28B 7039 6FED 9C63 4163:

curl -fsSL https://github.com/ahmed-g-gad.gpg | gpg --import
gpg --fingerprint 70396FED9C634163

& "$env:ProgramFiles\Git\bin\bash.exe" -c 'curl -fsSL https://github.com/ahmed-g-gad.gpg | gpg --import && gpg --fingerprint 70396FED9C634163'

ثم شغّل المُثبِّت:

curl -fsSL https://apothem.ahmedgad.com/install.sh | bash

irm https://apothem.ahmedgad.com/install.ps1 | iex

يتطلّب المُثبِّت Python 3.10+ على مستوى النظام، إضافةً إلى git وgpg للصيغة الشبكية. يتحقّق من المتطلّبات المُسبقة ويضع المحرّك تحت ~/.apothem. وعندما يكون click أو rich مفقودًا، يثبّت الحزمة بعد موافقتك، أو عند استخدام --yes (-Yes في PowerShell) أو APOTHEM_AUTO_INSTALL_DEPS=1، وإلا فيتوقّف مع أمر pip الذي يجب تشغيله (راجع المتطلّبات المُسبقة بلمحة). وعند الاكتمال يطبع لافتة الخطوات التالية؛ وفي POSIX، عندما يكون دليل الغلاف موجودًا بالفعل على PATH، تبدو اللافتة هكذا:

Installation complete.

The 'apothem' command is on your PATH.

Recommended first step — the guided setup (profile -> preview -> install):

  apothem quickstart

يغطّي دليل التثبيت مسارات التثبيت الأخرى — إضافة Claude Code (/plugin marketplace add ahmed-g-gad/apothem ثم /plugin install apothem@apothem)؛ وامتدادات عائلة VS Code وغيرها من الامتدادات الأصلية للأدوات؛ وصيغة npx عند الطلب (npx @ahmed-g-gad/apothem <command>) — إلى جانب خيارات متغيّرات البيئة.

2. أنشئ الملف التعريفي المشتركCopy Anchor Link

يكتب apothem profile init أصغر ملف تعريفي صالح وفق المخطط إلى ~/.config/apothem/profile.yaml. وإذا كان ملف تعريفي موجودًا هناك بالفعل، كما حين ينسخ المُثبِّت المثال في الخطوة 1، يتوقّف init بخطأ ويترك الملف دون تغيير؛ مرِّر --force للكتابة فوقه، أو احتفظ بالملف وحرِّره كما هو موضّح أدناه. ومرِّر --profile PATH عندما تحتفظ بملف تعريفي خاص بمشروع أو بـ CI في مكان آخر.

apothem profile init
apothem profile show --json

يستخدم الهيكل الأولي بيانات هوية نائبة زائفة، ومن الآمن تحريره قبل أن تُثبِّت أي مخرجات لإطار عمل. ويقرؤه show --json مجددًا ويُبلِغ عن الملف التعريفي المُتحقَّق منه مع ملء كل قيمة افتراضية، بدءًا بالحقل schema_version. يطبعه الأمر في سطر واحد؛ وهو مُوسَّع هنا:

{
  "schema_version": 1,
  "identity": {
    "name": "Example User",
    "role": "senior software engineer",
    "email": "[email protected]",
    "github": "example-user"
  },
  "preferences": {
    "language": "python",
    "style": "concise"
  },
  "rules": [],
  "seriousness": "PERSONAL_USE",
  "enforcement": {
    "sprints": false,
    "agent_teams": false,
    "multitasking": false,
    "continuous_execution": false,
    "learning_loop": false
  },
  "mcp_servers": {},
  "agent_mcp_servers": {},
  "harnesses": {},
  "exclude_harnesses": [],
  "workspace": {
    "directory_name": ".apothem",
    "scope": "project-local"
  }
}

وهنا أيضًا يظهر التعديل المشوّه — إذا كان YAML غير صالح، يُبلِغ show عنه هنا، قبل كتابة أي إعداد لإطار عمل. اجعل الملف التعريفي ملكك بالأمر apothem profile edit (يفتحه في محرّرك) أو اضبط مفتاحًا واحدًا في مكانه:

apothem profile set identity.name "Your Name"

3. ثبِّت محوّلات أُطُر العملCopy Anchor Link

جسِّد المحوّل الخاص بإطار عملك الأساسي. يقرأ هذا ملفك التعريفي ويكتب الإعداد الأصلي لتلك الأداة:

apothem install --harness claude-code

✓ Installed claude-code -> /home/you/.claude/settings.json

تكتب المحوّلات ذات نطاق المشروع ملف قواعدها داخل مشروع، لذا تحتاج إلى --project PATH؛ ويكتب سبعة منها أيضًا مهارات وقواعد مشتركة في مجلّدات داخل دليلك المنزلي، ولا يغيّر --project مكان كتابتها. عايِن أي تثبيت دون كتابة ملفات باستخدام --dry-run:

apothem install --harness cursor --project . --dry-run
apothem install --harness cursor --project .

ثبِّت المجموعة الكاملة المستندة إلى السجلّ دفعةً واحدة بالخيار --harness all. ولأن هذا الاختيار يكتب ملفات بنطاق المشروع وملفات بنطاق المستخدم معًا، يطبع الأمر الأهداف الفعلية مُجمَّعةً حسب الموقع. وفي الطرفية التفاعلية يطلب التأكيد قبل الكتابة خارج جذر المشروع. ويكتب التشغيل بلا طرفية، أو التشغيل مع --yes، أو التشغيل مع --format json دون سؤال؛ أما --dry-run فلا يكتب شيئًا. وشغّل المجموعة الكاملة بالأمر:

apothem install --harness all --project .

راجع القائمة الكاملة لأُطُر العمل لكل اسم مدعوم، ومرجع الأمر install لمجموعة الخيارات الكاملة.

4. تحقَّقCopy Anchor Link

التجسيد نصف العمل فقط؛ إذ يؤكّد verify أن ملفات الإعداد المتوقَّعة لإطار العمل قد وصلت وأنها صالحة:

apothem verify --harness claude-code

✓ claude-code is verified at /home/you/.claude/settings.json

يخرج verify برمز غير صفري إذا فُقد هدف مُدار، أو كان ملف مُدار فارغًا، أو لم يُحلَّل إعداد JSON أو YAML. وأضِف --profile PATH ليفشل أيضًا عندما يختلف ملف مثبّت عن ذلك الملف التعريفي، فيصبح verify فحصًا للانحراف؛ ومن دونه يبقى الإعداد القديم ناجحًا في التحقّق. ويتيح الخروج برمز غير صفري استخدام verify بوابةً في سكربت إعداد. وللتحقّق من صحّة الجهاز كله عبر كل محوّل مُسجَّل، شغّل:

apothem doctor

يفحص doctor كل إطار عمل مُثبَّت: يجب أن يجتاز التحقّق، ويجب أن يبدأ كل أمر خطّاف سجّله تثبيته. أما إطار العمل الذي لم تُثبِّته فيُدرَج لكنه لا يُعدّ فشلًا، لذا يخرج doctor بالقيمة 0 عندما لا يفشل أي فحص، حتى لو لم يكن مُثبَّتًا سوى إطار عمل واحد.

5. تشغيلك الأولCopy Anchor Link

افتح إطار العمل الذي أعددته للتوّ — Claude Code في هذا المثال — وابدأ جلسة في أي مشروع. الملف التعريفي الذي أعددته في الخطوة 2 صار الآن جزءًا من سلوك تلك الأداة. هذا هو التشغيل الأول العامل: ملف تعريفي واحد يُشكِّل جلسة حقيقية.

عندما تُغيِّر الملف التعريفي لاحقًا، أعِد تطبيقه دون إعادة التثبيت:

apothem update --harness claude-code

سمِّ محوّلًا آخر لإعادة تطبيق الملف التعريفي على تلك الأداة (وأضِف --project PATH للمحوّل ذي نطاق المشروع)، أو مرِّر --harness all --project . لإعادة تطبيقه على كل إطار عمل مدعوم.

الخطوات التاليةCopy Anchor Link

• أضِف مزيدًا من أُطُر العمل — كرِّر الخطوة 3 لكل أداة.
• اكتب قاعدتك الأولى — الوحدة التي يرثها كل إطار عمل.
• ألِّف خطة — قُد مهمة كاملة عبر خط أنابيب الخطة الحتمي.
• مرجع CLI — كل أمر، وراية، ورمز خروج.