انتقل إلى المحتوى

TidyFactor Skill Architect — محرك الحوكمة والمعايير الهندسية لمهارات الذكاء الاصطناعي v2.0.2

المعيار الحاكم ومحرك البناء المعماري لمهارات وكلاء البرمجة بالذكاء الاصطناعي
يطبق القواعد الهيكلية الاثنتي عشرة لمنظومة TidyFactor عبر Google Antigravity و Claude Code و Cursor و OpenAI Codex و Windsurf.

tidyfactor-skill-architect هي طبقة الحوكمة المركزية التي تلزم جميع مهارات وكلاء الذكاء الاصطناعي بالانضباط المعماري الصارم، وجودة الكود الحتمية، والتطابق السلوكي التام.

🎯 القيمة الهندسية والعملية

  1. انضباط الموجه (Dispatcher Discipline): تحجيم ملف SKILL.md ليكون موجهاً رشيقاً (~350 توكن) يعلن الأوامر ومسارات العمل دون حشو تنفيذي يشتت الذاكرة.
  2. مسار واحد = مخرج واحد (One Workflow = One Outcome): إلزام كل مسار عمل بمخرج هندسي وحيد وقائمة تحقق صريحة (## Validation checklist).
  3. الذاكرة التشغيلية النقية (Operational Memory): قواعد برمجية، مخططات، وأنماط فنية صرفة—بدون أي نصوص تسويقية أو ثرثرة إنشائية.
  4. القواعد المعمارية الاثنتا عشرة الصارمة: حظر المجلدات الفارغة، تقنين نمو الملفات بحسب حالات الاستخدام، الالتزام بالـ YAML Frontmatter الصارم، والاعتماد على أدوات النظام الحتمية.

🚀 التثبيت وإعداد الوكيل

# التثبيت السريع عبر NPM
npx @tidyfactor/cli-skill-architect add-skill

# أو التثبيت العام على مستوى النظام
npm install -g @tidyfactor/skill-architect

⚡ مرجع أوامر الوكيل البرمجي (Slash Commands)

الأمر دورة الحياة الوصف الهندسي
/init INIT تأسيس مهارة جديدة متوافقة مع الهيكلية الرباعية للمنظومة
/audit IMPROVE تدقيق مهارة قائمة وفحص مدى التزامها بالقواعد الـ 12 وحساب درجة المطابقة (X/12)
/test TEST توليد \(\ge 3\) سيناريوهات اختبار واقعية (مسار ناجح، حالة حدية، واختبار سلبي) في tests/scenarios.md
/grow IMPROVE تقييم مبررات إضافة ملفات جديدة استناداً لمعايير الحجم والفروع والتنوع

🏛️ القواعد الهيكلية الاثنتا عشرة لمهارات TidyFactor

1. انضباط الموجه              ← ملف SKILL.md موجه رشيق (~350 توكن)
2. مسار واحد = مخرج واحد      ← تسليم محدد مع قائمة تحقق إلزامية
3. ذاكرة تشغيلية نقية          ← أنماط برمجية وقواعد فنية بصفر حشو
4. حظر الهياكل الفارغة        ← هيكل تنظيمي مسطح ونظيف
5. عزل الفلسفة عن التنفيذ     ← فصل المفاهيم التسويقية عن الذاكرة التقنية
6. نمو مشروط بالحاجة          ← إضافة الملفات فقط عند وجود مبرر دورة حياة
7. الاعتماد على أدوات النظام    ← تغليف tsc و node و python و git
8. تطابق السلوك وإصدارات SSOT  ← سلوك متطابق ومزامنة ذرية للإصدارات
9. توافق المنصات وصحة YAML    ← مفسر yaml.safe_load()، وصف <= 1024 حرفاً، وإحاطة إجبارية "..."
10. إعلان صلاحيات الأدوات     ← تحديد اللغات ونطاق تعديل الملفات والشبكة صراحة في SKILL.md
11. حداثة الذاكرة التشغيلية   ← وسم last-verified إلزامي ومحدث خلال <= 180 يوماً
12. حدود المهارة وخوادم MCP   ← المنطق الثابت داخل المهارة والاتصالات الحية تفوض لخوادم MCP

🧠 نمط طبقة القرارات السياقية (Contextual Decision Layer — CDL)

للمهارات المعقدة التي يتوقف تنفيذها على خيارات معمارية وتصميمية كبرى قبل توليد الكود (مثل tidyfactor-styler أو tidyfactor-next):

  1. بروتوكول تحكيم رشيق (memory/decision-points.md): يحدد محفزات التوقف وشروط التخطي المنطقية، ويشير إلى الكتالوجات الأصلية المعتمدة دون تكرارها.
  2. استكشاف قبلي وتخزين مؤقت (/brief): إدارة حوار استكشافي وحفظ مخرجات الـ Brief في .tidyfactor/<skill>-brief.md لضمان تشغيل الأوامر التالية بصمت وسلاسة.
  3. تجميع أحادي للأسئلة مع أولوية حتمية: تجميع نقاط القرار غير المحسومة في جولة واحدة (بحد أقصى 3 أسئلة) وفق تراتبية الأولوية (D1 > D3 > D2 > D4 > D5).
  4. عقد الاستدعاء المباشر مقابل التعديل الحذر: الاستدعاء المباشر للأمر يعرض الخيارات دائماً؛ بينما مسارات التعديل (redesign) تحافظ صمتاً على الخيارات القائمة.
  5. نقد مطابقة القرارات (Axis 7: Decision Alignment): توسيع نظام النقد الذاتي القبلي بمحور سابع (D) لقياس مدى التزام الكود المولد بقرارات الـ Brief المعتمدة.

🛠️ محرك التحقق الآلي من النزاهة الهندسية

يتضمن مستودع المهارة أداة فحص رقمية مؤتمتة من 11 نقطة فحص:

# تشغيل أداة التحقق الشاملة
python tools/validate_skill.py

تتحقق الأداة تلقائياً من مزامنة إصدارات SemVer عبر ملفات الـ Metadata، وصحة صياغة الـ YAML Frontmatter عبر yaml.safe_load()، وميزانية التوكينات، وتواريخ حداثة الذاكرة، ووجود سيناريوهات الاختبار.

🔗 الروابط الرسمية