⚡ دليل سطر الأوامر (CLI) ومحركات التثبيت المستقلة¶

دليل شامل لأداة سطر الأوامر TidyFactor، ومعالج الإعداد التفاعلي ثلاثي المراحل، وبنية التثبيت المزدوجة المقاومة للأعطال، ومحركات التثبيت المستقلة عبر المنصات المتعددة.

🌟 نظرة عامة¶

توفر TidyFactor نظام توزيع متقدم خالي من التعقيد يتيح تثبيت وتفعيل مهارات وكلاء الذكاء الاصطناعي عبر 10+ بيئات ومحررات برمجية (Google Antigravity, Cursor, Claude Code, Windsurf, Cline, OpenAI Codex, و Global Gemini Config).

معالج الإعداد التفاعلي لـ TidyFactor الإكمال التلقائي لأوامر المهارات داخل محرر الكود

🏛️ بنية التثبيت المزدوجة المقاومة للأعطال (Dual-Redundant Architecture)¶

تطبق أداة TidyFactor مسار تثبيت ذكي ثلاثي المستويات يضمن وصول المهارات واستقرار التثبيت بنسبة 100% حتى في أوقات انقطاع شبكات السيرفرات الخارجية:

graph TD
    Start["npx @tidyfactor/cli add &lt;skill&gt;"] --> LocalCheck{"1. فحص مساحة العمل المحلية (Dev Mode)"}
    LocalCheck -->|موجودة محلياً| FastLocal["مزامنة سريعة بـ 0ms (Local Fast-Path)"]
    LocalCheck -->|غير موجودة| NPMPrimary{"2. القناة الأساسية: شبكة NPM"}

    NPMPrimary -->|نجاح التثبيت عبر npx| SyncTargets["تركيب وتوزيع المهارة في مجلدات الوكلاء"]
    NPMPrimary -->|انقطاع / حجب / انتهاء وقت| DirectCDN{"3. القناة الاحتياطية: سيرفر TidyFactor المباشر"}

    DirectCDN -->|تنزيل وفك ضغط أرشيف .skill| SyncTargets
    SyncTargets --> Completed["✔ المهارة جاهزة ومفعلة داخل المحرر"]

المستوى الأول (Local Fast-Path): إذا كان المطور يعمل داخل بيئة مستودع TidyFactor، يتم نسخ وتفعيل المهارة محلياً بدون استهلاك أي بيانات أو وقت انتظار.
المستوى الثاني (القناة الأساسية — NPM / NPX): تشغيل حزمة NPM الرسمية npx -y @alwkala/<skill> add-skill مستفيداً من الـ Cache المحلي والـ CDN العالمي لـ NPM.
المستوى الثالث (القناة الاحتياطية — Direct CDN Fallback): في حال تعطل NPM أو حجب الحزم، يقوم الـ CLI فوراً بتنزيل أرشيف المهارة .skill من خادم tidyfactor.com وفك ضغطه محلياً بالأدوات الأصلية لنظام التشغيل.

⚡ التشغيل السريع: المعالج التفاعلي ثلاثي المراحل¶

يرشد المعالج المطورين خطوة بخطوة لفحص مكدس المشروع واختيار المحرر المستهدف وتثبيت الحزم المطلوبة:

npx @tidyfactor/cli init

مراحل المعالج التفاعلي:¶

[Step 1/3] فحص البيئة واكتشاف الوكلاء: استكشاف نوع المشروع (PHP Monolith, Next.js SaaS, Static HTML, JS SPA) وتحديد الوكلاء النشطين في المجلد.
[Step 2/3] تحديد بيئة الوكيل المستهدف (Target IDE):
1) Current Workspace (.agents/skills/)
2) Cursor IDE (.cursor/skills/)
3) Claude Code (.claude/skills/)
4) Windsurf Cascade (.windsurf/skills/)
5) Cline / VS Code (.cline/skills/)
6) Global User Hub (~/.gemini/config/skills/)
7) ⚡ Auto Multi-Mount (التثبيت والتوزيع الشامل لجميع الوكلاء النشطين دفعة واحدة)
[Step 3/3] اختيار باقة العمل والمهارات:
1) 🌟 الباقة الموصى بها تلقائياً (مبنية على مكدس المشروع المكتشف)
2) 👑 الحزمة الشاملة الكاملة (الـ 12 مهارة مجتمعة)
3) 🎨 باقة الواجهات والتصميم (pack:design)
4) 🚀 باقة الـ SaaS و Next.js (pack:saas)
5) ⚙️ باقة مونوليث PHP والهندسة (pack:engineering)
6) 🏛️ باقة الحوكمة والعمليات (pack:governance)
7) 📦 استعراض باقات العمل المخصصة
8) 🗂️ التصفح حسب الفئة
9) 🧩 اختيار يدوي بالاسم

📦 باقات مسارات العمل الجاهزة (Curated Workflow Packs)¶

معرف الباقة	المهارات المشمولة	الغرض والاستخدام	أمر التثبيت السريع
`pack:design`	`tidyfactor-cinematic` `tidyfactor-design` `tidyfactor-styler`	صفحات الهبوط الفاخرة، استوديو التصميم الحي، وصقل الـ RTL	`npx @tidyfactor/cli add pack:design`
`pack:saas`	`tidyfactor-next` `tidyfactor-design` `tidyfactor-marketing` `tidyfactor-doc`	منصات SaaS متعددة المستأجرين مع Supabase RLS والـ SEO	`npx @tidyfactor/cli add pack:saas`
`pack:engineering`	`tidyfactor-php` `tidyfactor-htmx` `tidyfactor-js` `tidyfactor-html` `tidyfactor-doc`	مونويلث PHP 8.x، التفاعلية عبر HTMX، وسبا Vanilla JS	`npx @tidyfactor/cli add pack:engineering`
`pack:governance`	`tidyfactor-skill-architect` `tidyfactor-doc` `tidyfactor-github`	حوكمة المهارات، منصات التوثيق Docsify، وإدارة GitHub	`npx @tidyfactor/cli add pack:governance`
`pack:growth`	`tidyfactor-marketing` `tidyfactor-cinematic` `tidyfactor-styler`	محرك التسويق المباشر، استراتيجيات الـ SEO، ونمو التحويلات	`npx @tidyfactor/cli add pack:growth`

🍺 التثبيت عبر مدير الحزم Homebrew (أنظمة macOS و Linux)¶

لمطوري أجهزة Mac (معالجات Apple Silicon و Intel) وعبر Linuxbrew:

# 1. إضافة المستودع الرسمي لتايدي فاكتور
brew tap TidyFactor/tidyfactor

# 2. تثبيت أداة TidyFactor CLI عالمياً
brew install tidyfactor

# أو في أمر واحد مباشر:
brew install TidyFactor/tidyfactor/tidyfactor

بمجرد اكتمال التثبيت، يمكنك استخدام الأمر المباشر tidyfactor أو الاختصار tf:

tidyfactor list
tf add pack:design
tf doctor

💻 سكربتات التثبيت المستقلة بسطر واحد (بدون Node.js)¶

للخوادم الخفيفة وبيئات الـ CI/CD وللمطورين الذين لا يمتلكون Node.js:

أنظمة Linux و macOS (عبر Bash و cURL)¶

# الوضع التفاعلي (يدعم قراءة الإدخال عبر /dev/tty)
curl -fsSL https://tidyfactor.com/api/v1/install.sh | bash

# تثبيت باقة مخصصة مباشرة
curl -fsSL https://tidyfactor.com/api/v1/install.sh | bash -s -- pack:design

# تثبيت جميع المهارات الـ 12
curl -fsSL https://tidyfactor.com/api/v1/install.sh | bash -s -- all

أنظمة Windows (عبر PowerShell 5.1 و 7+)¶

# الوضع التفاعلي
irm https://tidyfactor.com/api/v1/install.ps1 | iex

# تثبيت باقة مخصصة
$Skill = 'pack:design'; irm https://tidyfactor.com/api/v1/install.ps1 | iex

# تثبيت جميع المهارات
$Skill = 'all'; irm https://tidyfactor.com/api/v1/install.ps1 | iex

🩺 أمر الفحص والتشخيص الشامل (Doctor)¶

فحص مساحة العمل الحالية، واكتشاف مكدس المشروع، والتأكد من تثبيت المهارات في بيئات الوكلاء:

npx @tidyfactor/cli doctor

🤖 أوامر الاستدعاء بعد التثبيت (Slash Commands)¶

بمجرد اكتمال التثبيت، اكتب /tidy أو الأوامر المباشرة داخل محادثة الوكيل الذكي:

/hero        → بناء تسلسل Canvas الفاخر (Cinematic)
/component   → صقل الواجهات البرمجية وضبط الـ RTL (Styler)
/tokens      → استدعاء لوحات الألوان ومحددات التصميم (Design)
/tenant      → ضبط عزل المستأجرين وسياسات Postgres RLS (Next)
/admin       → توليد الوحدات الإدارية المقفلة (PHP)
/strategy    → كتابة خطط التسويق والـ SEO المباشر (Marketing)
/site        → توليد مواقع التوثيق Docsify/MkDocs (Doc)
/ruleset     → إعداد قواعد حماية الفروع على GitHub (GitHub)