Everything Claude Code: ما بداخله وكيف تُثبّته
المستودع الآن باسم affaan-m/ECC: 71 وكيلاً و314 مهارة و98 أمراً و22 حزمة قواعد وبيئة تنفيذ للخطّافات في Claude Code. إليك القائمة وأوامر التثبيت كما هي، والأجزاء التي تستحق التفعيل فعلاً.
باختصار
- «Everything Claude Code» مجموعة إعدادات مجتمعية لـ Claude Code — وكلاء ومهارات وأوامر وقواعد وخطّافات وإعدادات MCP — يشرف عليها Affaan Mustafa. وهي ليست منتجاً من Anthropic.
- تغيّر اسم المستودع: github.com/affaan-m/everything-claude-code يحوّل الآن 301 إلى affaan-m/ECC، ومعرّف الإضافة هو ecc@ecc وليس everything-claude-code@everything-claude-code.
- عند الالتزام d2ef2680 (2026-11-06) تحتوي الشجرة على 71 وكيلاً و314 مجلد SKILL.md و98 ملف أوامر و22 حزمة قواعد و68 سكربتاً و8 أنواع من أحداث الخطّافات.
- ثبّته مرة واحدة لكل harness: إما المعالج المرشد (npx ecc-universal@2.2.3 setup) أو أوامر /plugin الأصلية. الجمع بين الطريقتين هو السبب الموثّق لتكرار المهارات وتشغيل الخطّافات مرتين.
حالة المستودع مُتحقَّق منها في 2026-11-12: 301,569 نجمة على GitHub، آخر إصدار v2.2.3 صدر في 2026-10-01، وآخر التزام d2ef2680 بتاريخ 2026-11-06. أعداد النجوم تتغيّر يومياً فاقرأها كلقطة. أعداد المجلدات وأرقام الإصدارات وأوامر التثبيت في هذه الصفحة مأخوذة من شجرة المستودع والبيانات الوصفية، لا منقولة عن مقالات مدوّنات.
ما هذه المجموعة فعلاً
إنها إضافة (plugin)، لا نموذج ولا تفرّع من Claude Code. يضم المستودع بيان `.claude-plugin/` وخمسة أنواع من أصول نصية — تعريفات وكلاء فرعيين ومهارات وأوامر شرطة مائلة وملفات قواعد وسكربتات خطّافات — يقرأها Claude Code من مجلد إعداداتك.
يصف المشروع نفسه بأنه إعدادات فائز في هاكاثون Anthropic: فاز المؤلف بهاكاثون Anthropic x Forum Ventures في سبتمبر 2025 ويقول إن المجموعة نمت من الاستخدام اليومي. رخصتها MIT، وهي طرف ثالث يديره المجتمع، ولا تنشرها Anthropic ولا تراجعها.
منذ سلسلة 2.x يُعاد توجيه الجذر نفسه إلى harness أخرى — Codex وOpenCode وCursor وGemini CLI وCopilot CLI وQwen وKimi Code وغيرها — عبر مجلدات محوّلات مثل `.codex/` و`.opencode/` و`.cursor/`. تتفاوت تكافؤ الميزات بحسب الـ harness، ولهذا يحتفظ ملف README بمصفوفة دعم.
- الإصدار
- v2.2.3 · 2026-10-01
- آخر التزام
- d2ef2680
- الرخصة
- MIT
- النجوم (لقطة)
- 301,569
ما داخل المستودع
الأعداد أدناه محسوبة من شجرة المستودع عند الالتزام d2ef2680 — 6,449 عنصراً دون اقتطاع — لا من جدول الملخص في README. أسماء المجلدات هي المعرّفات التي يطابقها Claude Code، لذا تُركت دون ترجمة.
| المجلد | العناصر | المحتوى |
|---|---|---|
agents/ | 71 | تعريفات وكلاء فرعيين بصيغة markdown مع frontmatter: planner وarchitect وcode-reviewer وsecurity-reviewer، ومراجعون لكل لغة (Go وPython وRust وJava وKotlin وTypeScript وRuby وF#)، ومعالجات أخطاء بناء لكل لغة. |
skills/ | 314 | مجلد لكل مهارة بداخله SKILL.md: مسار TDD ومراجعة أمنية وحلقة تحقّق وeval harness وضغط استراتيجي وأنماط للغات وأطر العمل، إضافة إلى مهارات مجالية للتعلم الآلي والبيانات والتشغيل. |
commands/ | 98 | ملفات أوامر الشرطة المائلة. المشروع ينتقل إلى واجهة قائمة على المهارات، لذا تُوصف هذه بأنها واجهات توافق مُصانة لا المدخل الأساسي. |
rules/ | 22 | معايير تُحمّل دائماً، مقسّمة إلى `common/` (غير مرتبطة بلغة) ومجلد لكل تقنية — typescript وpython وgolang وrust وjava وkotlin وswift وphp وcsharp وcpp وruby وperl وreact وreact-native وvue وnuxt وangular وdart وfsharp وarkts وweb. المجموع 122 ملف markdown. |
hooks/ | 7 | ملف hooks.json وسكربتات memory-persistence. هناك ثمانية أحداث موصولة: PreToolUse (10 مطابقات) وUserPromptSubmit وPreCompact وSessionStart (2) وPostToolUse (2) وPostToolUseFailure (2) وStop (8) وSessionEnd. |
scripts/ | 68 | أدوات Node.js متعددة المنصات: المثبّت وdoctor وrepair وuninstall وفحص الجلسات وmemory وeval harness ومحوّلات Codex وOpenCode. |
contexts/ | 3 | ملفات dev.md وreview.md وresearch.md — سياقات بديلة لمطالبة النظام يمكن حقنها لجلسة واحدة. |
mcp-configs/ | 1 | ملف `mcp-servers.json` واحد فيه تعريفات خوادم MCP تُنسخ إلى `~/.claude.json` بعد استبدال المفاتيح النائبة. |
legacy-command-shims/ | 12 | أوامر قصيرة مسحوبة من الخدمة تُترك للتفعيل الصريح مثل /tdd و/e2e و/eval و/verify و/orchestrate، وكل منها يشير إلى المهارة التي حلّت مكانه. |
القواعد والمهارات اختيارية بحكم التصميم: تثبيت الإضافة لا يستطيع تسليم القواعد لأن إضافات Claude Code لا تملك قناة rules. لهذا يطلب README نسخ مجلدات القواعد يدوياً.
كيف تثبّته في Claude Code
ثلاثة مسارات، كلها منقولة حرفياً من README. اختر واحداً لكل harness — فـ README نفسه يحذّر من أن جمع طريقتين يكرّر المهارات والأوامر والخطّافات.
المسار 1 — المعالج المرشد (موصى به)
يثبّت إضافة `ecc@ecc` أو يحدّثها أو ينقلها إلى النطاق الذي تختاره (user أو project أو local) ويضبط ملف الخطّافات. يحتاج Node.js 18 أو أحدث ولا يتطلب استنساخ المستودع. مكافئات pnpm وYarn 2+ وBun هي `pnpm dlx` / `yarn dlx` / `bunx` بالمعاملات نفسها.
npx ecc-universal@2.2.3 setupالمسار 2 — أوامر الإضافة الأصلية
نفّذها داخل جلسة Claude Code (2.1 أو أحدث). تثبّت المهارات والوكلاء والأوامر والخطّافات التي تديرها الإضافة، وينتهي الأمر عند هذا الحد — لا تُشغّل تثبيتاً يدوياً كاملاً بعدها.
/plugin marketplace add https://github.com/affaan-m/ECC/plugin install ecc@eccالمسار 3 — القواعد، التي لا تثبّتها أي إضافة
إضافات Claude Code لا توزّع rules، لذا يطلب README استنساخ المستودع ونسخ الحزم التي تريدها. ابدأ بـ `rules/common` مع حزمة لغة واحدة؛ والسطر الثاني من cp في الكتلة هو الذي تستبدله بتقنيتك.
git clone https://github.com/affaan-m/ECC.gitcd ECCmkdir -p ~/.claude/rules/ecccp -R rules/common ~/.claude/rules/ecc/cp -R rules/typescript ~/.claude/rules/ecc/ # replace with your stackتأكّد من نجاح التثبيت
داخل Claude Code يجب أن يُظهر `/plugin list ecc@ecc` الإضافة مفعّلة، وتظهر أوامر الإضافة بنطاق اسمي — `/ecc:plan` لا `/plan`. وإذا ركّبت أكثر من طريقة وظهر التكرار، فالحل في README هو إلغاء التثبيت ثم التثبيت مرة واحدة.
ما تحتاجه أولاً
- 1Claude Code 2.1 أو أحدث في PATH. يذكر README أن الحد الأدنى v2.1.0 بسبب طريقة تحميل نظام الإضافات للخطّافات.
- 2Node.js 18 أو أحدث للمعالج وسكربتات الخطّافات، التي أُعيدت كتابتها بـ Node.js لتعمل على Windows وmacOS وLinux.
- 3Git، ونسخة مستنسخة مُراجَعة إن كنت تنوي نسخ القواعد أو قراءة سكربتات الخطّافات قبل تفعيلها.
أي الأجزاء يستحق الاستخدام
المستودع فهرس لا منتج، والمؤلف يقول ذلك: «ابدأ بما يلامسك، عدّله لتقنيتك، واحذف ما لا تستخدمه». على هذا الأساس تتركّز القيمة في أربعة أجزاء.
- 1
تعريفات الوكلاء الفرعيين
دور المراجعة أو التخطيط سهل التقييم: افتح agents/code-reviewer.md أو agents/planner.md واقرأ المطالبة ثم قرّر إن كنت تريد هذا الصوت في جلساتك. نسخ ملف واحد إلى ~/.claude/agents/ لا يكلّف شيئاً ولا يحتاج إضافة.
- 2
مهارات TDD والتحقّق
tdd-workflow وverification-loop وeval-harness هي جوهر ما بُنيت عليه أدلة المؤلف: تكتب «اختبر الفشل أولاً» و«تحقّق قبل أن تقول إنك انتهيت» كخطوات لا كنصيحة. اقرأها قبل التثبيت — إنها تغيّر سير الجلسة.
- 3
حزم القواعد
rules/common هو الأصل الأكثر قابلية للنقل في المستودع: معايير قصيرة تُحمّل دائماً عن الاختبار والأمان وسير عمل git وأسلوب الكود. ولأنها markdown خالص تعمل مع أي وكيل يقرأ ملف قواعد أو ذاكرة، وهي الأسهل في التقليم إلى أسلوب فريقك.
- 4
بيئة الخطّافات — بالانتقاء
الخطّافات هي المكان الذي تفرض فيه المجموعة شيئاً فعلاً: خطّاف Stop يشغّل فحص التنسيق والأنواع، وبوابة PreToolUse لأوامر الشل المدمّرة، وسكربتات ذاكرة عند بداية الجلسة ونهايتها. وهي أيضاً الجزء الأوسع سطحاً، لذا فعّلها واحداً واحداً واقرأ السكربت أولاً. ولهذا وُجد ECC_HOOK_PROFILE (minimal / standard / strict) وECC_DISABLED_HOOKS.
تحفّظات قبل التثبيت
هذه مقايضات ظاهرة من README وبنية المستودع، وليست افتراضات.
- إنها طرف ثالث وغير رسمية. عمل مجتمعي برخصة MIT وليس منتجاً من Anthropic. ويحذّر README نفسه بأن القنوات المصانة هي مستودع GitHub وحزمتا npm المسمّاة ecc-universal وecc-agentshield ومعرّف ecc@ecc وموقع ecc.tools فقط، وأن النسخ المرآة قد تحمل برمجيات خبيثة.
- تكلفة السياق حقيقية. المهارات تُحمّل عند الطلب، لكن القواعد المحمّلة دائماً وسياق SessionStart تُحتسب في كل دور: يحدّ README سياق SessionStart الإضافي بـ 8,000 حرف افتراضياً ويتيح ECC_SESSION_START_MAX_CHARS وECC_SESSION_START_CONTEXT=off لتخفيضه. ويحذّر README نفسه من أن كثرة أدوات MCP قد تقلّص نافذة 200k إلى نحو 70k.
- قد يتعارض مع إعداداتك الحالية. القواعد تذهب إلى ~/.claude/rules/ecc/ والوكلاء إلى ~/.claude/agents/ والخطّافات إلى hooks.json الخاص بالإضافة — ملفات منفصلة لكنها المجلدات نفسها التي تعيش فيها وكلاؤك وقواعدك، فاحتمال تصادم الأسماء قائم. ومسار الإصلاح في README هو `npx ecc-universal@2.2.3 doctor` ثم `repair`.
- المعرّفات تغيّرت. المقالات القديمة تثبّت everything-claude-code@everything-claude-code من affaan-m/everything-claude-code؛ وكلاهما الآن يُحلّ إلى affaan-m/ECC وecc@ecc. ويسمّي README الصيغة الطويلة اسماً بديلاً قديماً.
- الخطّافات إعدادات قابلة للتنفيذ. إنها تشغّل أوامر شل على جهازك عند أحداث الأدوات. اقرأ hooks/hooks.json والسكربتات تحت scripts/hooks/ قبل تفعيلها، ولا تنسخ hooks.json إلى settings.json فوق تثبيت الإضافة — فـ README يوثّق ذلك كسبب لأخطاء تكرار الخطّافات.
إن أخذت شيئاً واحداً فقط
خُذ القواعد ومهارة أو مهارتين. قيمة هذه المجموعة ليست في فهرس 314 مهارة — لا أحد يراجع 314 مهارة — بل في تلك الأصول القليلة التي تكتب سير عمل تؤمن به أصلاً، مع تذكير بأن السياق المحمّل دائماً له ثمن. وما بقي يمكن أن ينتظر حتى تتعطّل جلسة فعلاً.