ECC لتحسين harness الوكلاء: المهارات والـ hooks والأمان

ECC لتحسين harness الوكلاء: ثبّت مستودع MIT وفق README، وحدّد سقف السياق المحقون، وقس الرموز المميّزة باستخدام OpenTelemetry.
ECC optimisation harnais agents : skills, hooks et sécurité

ECC لتحسين harness الوكلاء هو موضوع المستودع affaan-m/ECC، وهو نظام مفتوح المصدر يصف نفسه بأنه «نظام تشغيل لـ harness الوكلاء» (agent harness: الحزمة التي تحيط بالنموذج وتشغّله). يضيف إلى وكيل البرمجة لديك (Claude Code في المقام الأول) وكلاء متخصصين ومهارات وhooks وقواعد وذاكرة وماسحًا أمنيًا، بدورة معلنة «خطّط، اختبر، نفّذ، راجع، تحقق، احفظ في الذاكرة، تحسّن». يعرض المستودع نحو 286 000 نجمة في منتصف أكتوبر 2026: إنه من أكثر المستودعات متابعة على GitHub.

لمثل هذا الـ harness الغني كلفة تشغيلية: سياق يُحقن عند البدء، وhooks تُنفَّذ عند كل أداة، وذاكرة تتراكم، وسكربتات مثبتة على جهازك. يتبع هذا المقال README في التثبيت، ثم يفصّل ما يجب ضبطه وقياسه وتدقيقه قبل اعتماده في فريق.

لم تثبّت span.observer ECC ولم تشغّله لأجل هذا المقال. الأوامر من README واللقطات مقتطفات معروضة من مقاطعه.

ECC لتحسين harness الوكلاء: ما يقوله المستودع

  • المؤلف والترخيص: مستودع شخصي للمستخدم affaan-m؛ ترخيص MIT «إلى الأبد» بحسب README، الذي يعرض أيضًا عرضًا مستضافًا مدفوعًا (ECC Pro، وهو GitHub App للمستودعات الخاصة) ورعاية.
  • أرقام أُعيدت قراءتها في 22 أكتوبر 2026 من صفحة المستودع: نحو 286 000 نجمة، ونحو 42 400 تفرّع، و3 957 إيداعات على الفرع الرئيسي. يذكر README الإصدار الحالي 2.2.3 (1 أكتوبر 2026)؛ ولا تعرض صفحة المستودع إصدار GitHub.
  • المحتوى المعلن في README: 71 وكيلًا و311 مهارة و97 «command shims» للتوافق، إضافة إلى hooks وقواعد وذاكرة وتعلم مستمر والماسح AgentShield. تتغير هذه الأرقام من إصدار إلى آخر: وكانت صورة الصفحة الرئيسية للمستودع تعرض أرقامًا أخرى عند آخر تركيب لها.
  • الأهداف: الأفضل مع Claude Code؛ مسارات أصلية لـ Codex وQoder؛ ومحوّلات «بقدرات محدودة» لـ Cursor وOpenCode وGemini وZed وGitHub Copilot وغيرها. ويدعو README إلى قراءة مصفوفة الدعم قبل افتراض تكافؤ الوظائف.
  • اللغات: يعرض README لغات Shell وTypeScript وPython وGo وJava وPerl وMarkdown.

ECC ليس منتجًا من Dynatrace. وتُقاس آثاره على السياق والتكاليف عبر OpenTelemetry، سواء استخدمت Dynatrace SaaS أو Dynatrace Managed.

التثبيت خطوة بخطوة

يشدد README على نقطة: لا تثبّت ECC إلا من قنواته الرسمية (المستودع، وحزمتا npm هما ecc-universal وecc-agentshield، وإضافة ecc@ecc، وموقع ecc.tools)، لأن النسخ الخارجية قد تحتوي على برمجيات خبيثة.

المتطلبات المسبقة

Node.js 18 أو أحدث للحزمة الشاملة؛ وللإضافة الخاصة بـ Claude: Git وClaude Code 2.1 أو أحدث في PATH.

المعالج الموجَّه (يوصي به README)

npx [email protected] setup

يضيف README خطوات لنظام Windows (PowerShell): التحقق من node --version وgit --version وclaude --version، وتشغيل الأمر، واختيار «Global user» وhooks من نوع «Standard»، ثم التحقق بـ /plugin list من تفعيل ecc@ecc. ويجرد المعالج نطاقات Claude الموجودة قبل أن يكتب أي شيء.

أوامر Claude Code الأصلية

الأمران أدناه يثبّتان الإضافة نفسها. ويطلب README اختيار طريقة واحدة لكل harness وعدم تكديس تثبيت يدوي كامل فوقها.

مقتطف من README لـ ECC: أمرا npx ecc-universal setup وinstall --guided، ثم أوامر /plugin marketplace add و/plugin install ecc@ecc و/plugin list في Claude Code
Source : github.com

يلاحظ README أن الإصدار المثبّت (@2.2.3) ليس تدقيقًا أمنيًا ولا فحص سلامة: راجع المصدر وسلامة الحزمة قبل تنفيذ شيفرتها. والقواعد لا تمر عبر الإضافة: يشرح README نسخ rules/common وحزمة لغة يدويًا إلى ~/.claude/rules/ecc.

إلغاء التثبيت

إن كدّست عدة تثبيتات، يحيل README إلى قسمه «Reset / Uninstall»، وينصح بـ node scripts/ecc.js doctor ثم repair قبل إعادة التثبيت.

الاستخدام: ابدأ بسير عمل لا بالكتالوج

يقترح README الانطلاق من الحاجة: /ecc:plan ثم المهارة tdd-workflow لميزة، و/code-review لمراجعة بسياق جديد، و/build-fix لإصلاح بناء، و/context-budget لمراقبة ضغط السياق، و/save-session و/resume-session للذاكرة، و/security-scan لتدقيق إعداد الوكيل. المهارات هي الواجهة الرئيسية، والأوامر مجرد اختصارات للتوافق.

ضبط الكلفة: السياق والـ hooks والذاكرة

أكثر نقاط التشغيل واقعية في README قائمة متغيرات البيئة التي تحدّ ما يحقنه ECC في السياق. إنها روافع مباشرة على استهلاك الرموز، نتناولها في كلفة وكيل ذكاء اصطناعي بالرموز.

مقتطف من README لـ ECC: متغيرات البيئة ECC_HOOK_PROFILE وECC_SESSION_START_MAX_CHARS وECC_SESSION_START_CONTEXT وECC_MAX_INJECTED_INSTINCTS وECC_CONTEXT_MONITOR_COST_WARNINGS وقيمها الافتراضية في التعليقات
Source : github.com
  • ECC_HOOK_PROFILE: شدة الـ hooks، والافتراضي «standard».
  • ECC_SESSION_START_MAX_CHARS: سقف السياق المضاف عند بدء الجلسة، 8 000 حرف افتراضيًا بحسب README.
  • ECC_SESSION_START_CONTEXT=off: يعطّل هذا السياق، وهو مخصص للإعدادات ذات السياق الصغير أو مع نموذج محلي.
  • ECC_MAX_INJECTED_INSTINCTS: عدد «الغرائز» (instincts) المتعلَّمة المحقونة عند البدء، 6 افتراضيًا.
  • ECC_CONTEXT_MONITOR_COST_WARNINGS=off: يُبقي تنبيهات السياق ويزيل تقديرات الكلفة بسعر API.

ويذكر README أيضًا مدة احتفاظ بالجلسات المؤقتة، 30 يومًا افتراضيًا (ECC_SESSION_RETENTION_DAYS). وللذاكرة والسياق، يتخذ مشروعان آخران من السلسلة خيارات مجاورة: context-mode وHindsight.

الأمان: الـ harness سطح هجوم

يجعل ECC الأمان حجة: يقول README إن إعداد الوكيل لديه غير موثوق افتراضيًا. ويوفر AgentShield، وهو ماسح أوامره الموثقة agentshield scan --path . و--fix وagentshield init. يطبقه README على ملفات CLAUDE.md وsettings.json وإعدادات MCP والـ hooks وتعريفات الوكلاء والمهارات. ويشترط ملفًا تنفيذيًا مثبتًا ومراجعًا مسبقًا: ويوضح أن النشر على سجل (registry) ليس تدقيقًا.

ويصف README كذلك حارسًا (GateGuard) يفحص أوامر shell المدمّرة قبل تنفيذها. هذه ادعاءات من المشروع؛ ولم نختبرها. وللإطار العام، راجع ضوابط حماية وكلاء الذكاء الاصطناعي في الإنتاج.

الحدود والنقاط المفتوحة

  • سطح واسع جدًا: مئات ملفات المهارات والوكلاء والـ hooks. كل إضافة نص أو شيفرة تقود وكيلك: راجعها قبل التفعيل.
  • التكافؤ بين الـ harness: بعض الأهداف فقط لها مسارات أصلية؛ والبقية محدودة.
  • أرقام متغيرة: الوكلاء والمهارات والأوامر تختلف بين الإصدارات؛ لا تذكرها دون تاريخ.
  • النموذج الاقتصادي: مشروع MIT مع عرض مدفوع مرتبط به. لا شيء شاذًا، لكن يجب أن تعلم.
  • مشرف وحيد معلن: يتحدث README عن مشرف واحد ينشر كل أسبوع؛ فضع خطة إن تغير الإيقاع.

مراقبة ECC باستخدام OpenTelemetry

لا يصف README تصديرًا إلى OpenTelemetry خاصًا بـ ECC. تأتي الإشارات من العميل:

  • الحدث claude_code.tool_result (اسم الأداة والحالة والمدة) والرموز لكل جلسة، راجع مراقبة وكيل برمجة في المؤسسة؛
  • مقارنة الرموز لكل جلسة مع ECC وبدونه، أو مع سياق بدء محدد السقف، لتقدير الأثر الحقيقي على مستودعاتك؛
  • سجلات الـ hooks وتنبيهات السياق في ECC، تُحفظ أدلةً على ما مُنع الوكيل من فعله.

كيف تتحقق من أن كل شيء يعمل

  1. يُظهر /plugin list ecc@ecc الإضافة مفعّلة، مرة واحدة فقط.
  2. يحقن بدء جلسة جديدة سياقًا محدودًا بالمتغيرات أعلاه.
  3. تُظهر تتبعاتك استدعاءات الأدوات بمدتها وحالتها، واستهلاك الرموز في الجلسة.

أفضل الممارسات

  • ثبّت من القنوات الرسمية وثبّت الإصدار.
  • فعّل مهارات قليلة وملف hooks قياسيًا، ثم وسّع.
  • قس الرموز قبل التثبيت وبعده.
  • مرّر AgentShield (أو تدقيقًا آخر) على إعدادك، لا على الشيفرة فقط.
  • تجنب تكديس الإضافة مع تثبيت يدوي كامل.

الأسئلة الشائعة

هل يعمل ECC مع Claude Code فقط؟

لا: يصف README مسارات أصلية لـ Codex وQoder ومحوّلات أكثر محدودية لأدوات أخرى، لكنه يذكر أن Claude Code هو الأفضل دعمًا.

هل يزيد ECC استهلاك الرموز؟

يحقن سياقًا عند البدء ويحمّل مهارات؛ ويوفر README متغيرات لتحديد سقفه. الأثر الصافي على مستودعاتك يُقاس ولا يُفترض.

هل أحتاج إلى العرض المدفوع؟

يؤكد README أن المستودع يبقى مجانيًا بترخيص MIT؛ والعرض المستضاف يخص المستودعات الخاصة عبر GitHub App.

الخلاصة

ECC أقرب إلى حزمة ممارسات مُعبّأة لوكلاء البرمجة منه إلى أداة. فائدته للفريق في روافعه (ملفات الـ hooks، وسقف السياق، والذاكرة، وتدقيق الإعداد)؛ ومخاطره في حجمه. اعتمده بخطوات صغيرة، وقس الرموز، ودقّق الإعداد. المصدر: مستودع affaan-m/ECC.

span.observer مدوّنة مجتمعية مستقلة وغير تابعة لشركة Dynatrace LLC ولا للمشاريع المذكورة ولا لـ Anthropic. العلامات التجارية المذكورة ملك لأصحابها. الأدوات تتطور بسرعة، لذا تحقق دائمًا من الأوامر والخيارات في وثائقها الرسمية.

Total
0
Shares
Leave a Reply

Your email address will not be published. Required fields are marked *

Previous Post
AI engineering from scratch parcours IA : le cursus du dépôt

AI engineering from scratch: مسار تعلم الذكاء الاصطناعي في المستودع

Next Post
Octop assistant IA auto-hébergé : installer et sécuriser

Octop: مساعد ذكاء اصطناعي مستضاف ذاتيًا، التثبيت والتأمين

Related Posts